Platform SDK: DirectX

D3DXGetDeviceDescription

The D3DXGetDeviceDescription function retrieves a description of the specified device.

HRESULT D3DXGetDeviceDescription(
  DWORD deviceIndex,
  D3DX_DEVICEDESC* pd3dxDeviceDesc
); 

Parameters

deviceIndex
An index value specifying the device. Device indexing begins at zero. Using D3DX_DEFAULT for this parameter specifies the device with the highest acceleration level afforded by the primary surface.
pd3dxDeviceDesc
A pointer to the D3DX_DEVICEDESC structure to be filled with the capabilities of the specified device.

Return Values

If the function succeeds, the return value is S_OK.

If the function fails, the return value may be one of the following values:

D3DXERR_D3DXNOTSTARTEDYET
D3DXERR_INITFAILED
D3DXERR_INVALIDD3DXDEVICEINDEX
D3DXERR_NULLPOINTER

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxcore.h.
  Library: Use d3dx.lib.

See Also

D3DXGetDeviceCaps, D3DXGetDeviceCount