IDirect3D8::GetAdapterIdentifier

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

HRESULT GetAdapterIdentifier(
  UINT Adapter,
  DWORD Flags,
  D3DADAPTER_IDENTIFIER8* pIdentifier
);

Parameters

Adapter

[in] 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 IDirect3D8::GetAdapterCount.

Flags

[in] Parameter that is typically set to zero. However, you can specify the following value.

D3DENUM_NO_WHQL_LEVEL

Forces the WHQLLevel member of the D3DADAPTER_IDENTIFIER8 structure to be zero, meaning that no information is returned for the WHQL digitally-signed date. Setting this flag will avoid the one- or two-second time penalty incurred to determine the WHQL certification date.

pIdentifier

[out] Pointer to a D3DADAPTER_IDENTIFIER8 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 Values

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 unwriteable memory.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.

See Also

IDirect3D8::GetAdapterCount