Microsoft DirectX 9.0 |
Retrieves device-specific information about a device.
Syntax
HRESULT GetDeviceCaps(
UINT Adapter, D3DDEVTYPE DeviceType, D3DCAPS9 *pCaps );
Parameters
- Adapter
- [in] Ordinal number that denotes the display adapter. D3DADAPTER_DEFAULT is always the primary display adapter.
- DeviceType
- [in] Member of the D3DDEVTYPE enumerated type. Denotes the device type.
- pCaps
- [out] Pointer to a D3DCAPS9 structure to be filled with information describing the capabilities of the device.
Return Value
If the method succeeds, the return value is D3D_OK.
If the method fails, the return value can be one of the following values.
D3DERR_INVALIDCALL The method call is invalid. For example, a method's parameter may have an invalid value. D3DERR_INVALIDDEVICE The requested device type is not valid. D3DERR_OUTOFVIDEOMEMORY Direct3D does not have enough display memory to perform the operation.
Remarks
The application should not assume the persistence of vertex processing capabilities across Microsoft® Direct3D® device objects. The particular capabilities that a physical device exposes may depend on parameters supplied to IDirect3D9::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.