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

See also

IDirect3D9