IDirect3D9::GetAdapterIdentifier method (d3d9.h)

Describes the physical display adapters present in the system when the IDirect3D9 interface was instantiated.


HRESULT GetAdapterIdentifier(
  [in]  UINT                   Adapter,
  [in]  DWORD                  Flags,
  [out] D3DADAPTER_IDENTIFIER9 *pIdentifier


[in] Adapter

Type: UINT

Ordinal number that denotes the display adapter. D3DADAPTER_DEFAULT is always the primary display adapter. The minimum value for this parameter is 0, and the maximum value for this parameter is one less than the value returned by GetAdapterCount.

[in] Flags


Flags sets the WHQLLevel member of D3DADAPTER_IDENTIFIER9. Flags can be set to either 0 or D3DENUM_WHQL_LEVEL. If D3DENUM_WHQL_LEVEL is specified, this call can connect to the Internet to download new Microsoft Windows Hardware Quality Labs (WHQL) certificates.

Differences between Direct3D 9 and Direct3D 9Ex:

D3DENUM_WHQL_LEVEL is deprecated for Direct3D9Ex running on Windows Vista, Windows Server 2008, Windows 7, and Windows Server 2008 R2 (or more current operating system). Any of these operating systems return 1 in the WHQLLevel member of D3DADAPTER_IDENTIFIER9 without checking the status of the driver.

[out] pIdentifier


Pointer to a D3DADAPTER_IDENTIFIER9 structure to be filled with information describing this adapter. If Adapter is greater than or equal to the number of adapters in the system, this structure will be zeroed.

Return value


If the method succeeds, the return value is D3D_OK. D3DERR_INVALIDCALL is returned if Adapter is out of range, if Flags contains unrecognized parameters, or if pIdentifier is NULL or points to unwritable memory.


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

See also