DirectX SDK

IDirect3DDevice7::GetCaps

The IDirect3DDevice7::GetCaps method retrieves the capabilities of the Direct3D device.

HRESULT GetCaps(
  LPD3DDEVICEDESC7 lpD3DDevDesc,  
);

Parameters

lpD3DDevDesc: Address of the D3DDEVICEDESC7 structure to contain the hardware features of the device.

Return Values

If the method succeeds, the return value is D3D_OK.

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

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

Remarks

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

In previous versions of this interface, this method simultaneously retrieved capabilities for hardware abstraction layer (HAL) devices and hardware emulation layer (HEL) devices by accepting pointers to the legacy D3DDEVICEDESC structure. In the IDirect3DDevice7 interface, this method only retrieves the capabilities of the device on which the method is called.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.