IDirect3D9::GetDeviceCaps method (d3d9.h)

Retrieves device-specific information about a device.

Syntax

HRESULT GetDeviceCaps(
  [in]  UINT       Adapter,
  [in]  D3DDEVTYPE DeviceType,
  [out] D3DCAPS9   *pCaps
);

Parameters

[in] Adapter

Type: UINT

Ordinal number that denotes the display adapter. D3DADAPTER_DEFAULT is always the primary display adapter.

[in] DeviceType

Type: D3DDEVTYPE

Member of the D3DDEVTYPE enumerated type. Denotes the device type.

[out] pCaps

Type: D3DCAPS9*

Pointer to a D3DCAPS9 structure to be filled with information describing the capabilities of the device.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DERR_INVALIDDEVICE, D3DERR_OUTOFVIDEOMEMORY, and D3DERR_NOTAVAILABLE.

Remarks

The application should not assume the persistence of vertex processing capabilities across Direct3D device objects. The particular capabilities that a physical device exposes may depend on parameters supplied to CreateDevice. For example, the capabilities may yield different vertex processing capabilities before and after creating a Direct3D Device Object with hardware vertex processing enabled. For more information see the description of D3DCAPS9.

Requirements

Requirement Value
Target Platform Windows
Header d3d9.h (include D3D9.h)
Library D3D9.lib

See also

IDirect3D9