IDirect3DDevice2::GetCaps

The IDirect3DDevice2::GetCaps method retrieves the capabilities of the Direct3DDevice2 object.

HRESULT GetCaps(
  LPD3DDEVICEDESC lpD3DHWDevDesc,  
  LPD3DDEVICEDESC lpD3DHELDevDesc  
);
 

Parameters

lpD3DHWDevDesc

Address of the D3DDEVICEDESC structure that will contain the hardware features of the device.

lpD3DHELDevDesc

Address of the D3DDEVICEDESC structure that will contain the software emulation being provided.

Return Values

If the method succeeds, the return value is D3D_OK.

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

Remarks

This method does not retrieve the capabilities of the display device. To retrieve this information, use the IDirectDraw2::GetCaps method.

This method is unchanged from its implementation in the IDirect3DDevice interface.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.