IDirect3D8::GetAdapterIdentifier

  • Article

This method 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.

    Value Description
    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 certification date. Setting this flag will avoid the one- or two-second time penalty incurred to determine the WHQL certification date.

  • pIdentifier
    [in, 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 unwritable memory.

Requirements

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

See Also

IDirect3D8 | IDirect3D8::GetAdapterCount | D3DADAPTER_IDENTIFIER8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.