IDirect3D9::GetAdapterIdentifier method (d3d9.h)

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

Syntax

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

Parameters

[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

Type: DWORD

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

Type: D3DADAPTER_IDENTIFIER9*

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

Type: HRESULT

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.

Requirements

See also

GetAdapterCount

IDirect3D9