IDirect3D8::GetDeviceCaps

This method retrieves device-specific information about a device.

HRESULT GetDeviceCaps(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DCAPS8* 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 D3DCAPS8 structure to be filled with information describing the capabilities 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 values:

• D3DERR_INVALIDCALL
• D3DERR_INVALIDDEVICE
• D3DERR_OUTOFVIDEOMEMORY

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 IDirect3D8::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 D3DCAPS8.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

D3DDEVTYPE | IDirect3D8::CreateDevice | D3DCAPS8 | IDirect3D8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.