IDirect3D9::GetAdapterIdentifier Method

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

Syntax

HRESULT GetAdapterIdentifier(      

    UINT Adapter,
    DWORD Flags,
    D3DADAPTER_IDENTIFIER9 *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 IDirect3D9::GetAdapterCount.

Flags

[in] Flags sets the WHQLLevel member of D3DADAPTER_IDENTIFIER9. Flags can be set to either D3DENUM_WHQL_LEVEL or zero. The default value is zero. If D3DENUM_WHQL_LEVEL is specified, this call can connect to the Internet to download new Microsoft?Windows?Hardware Quality Labs (WHQL) certificates.

pIdentifier

[out] 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 unwriteable memory.

See Also

IDirect3D9::GetAdapterCount