IDirect3D9::GetAdapterIdentifier-Methode (d3d9helper.h)

Beschreibt die physischen Grafikkarten, die im System vorhanden sind, als die IDirect3D9-Schnittstelle instanziiert wurde.

Syntax

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

Parameter

[in] Adapter

Typ: UINT

Ordnungszahl, die die Grafikkarte angibt. D3DADAPTER_DEFAULT ist immer der primäre Grafikkarte. Der Mindestwert für diesen Parameter ist 0, und der Höchstwert für diesen Parameter ist ein Wert kleiner als der von GetAdapterCount zurückgegebene Wert.

[in] Flags

Typ: DWORD

Flags legt den WHQLLevel-Member von D3DADAPTER_IDENTIFIER9 fest. Flags können entweder auf 0 oder D3DENUM_WHQL_LEVEL festgelegt werden. Wenn D3DENUM_WHQL_LEVEL angegeben ist, kann dieser Aufruf eine Verbindung mit dem Internet herstellen, um neue WHQL-Zertifikate (Microsoft Windows Hardware Quality Labs) herunterzuladen.

Unterschiede zwischen Direct3D 9 und Direct3D 9Ex:

D3DENUM_WHQL_LEVEL ist für Direct3D9Ex unter Windows Vista, Windows Server 2008, Windows 7 und Windows Server 2008 R2 (oder aktuelleres Betriebssystem) veraltet. Jedes dieser Betriebssysteme gibt 1 im WHQLLevel-Member von D3DADAPTER_IDENTIFIER9 zurück, ohne die status des Treibers zu überprüfen.

[out] pIdentifier

Typ: D3DADAPTER_IDENTIFIER9*

Zeiger auf eine D3DADAPTER_IDENTIFIER9 Struktur, die mit Informationen gefüllt werden soll, die diesen Adapter beschreiben. Wenn der Adapter größer oder gleich der Anzahl der Adapter im System ist, wird diese Struktur auf null gesetzt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. D3DERR_INVALIDCALL wird zurückgegeben, wenn der Adapter außerhalb des Bereichs liegt, wenn Flags nicht erkannte Parameter enthält oder wenn pIdentifier NULL ist oder auf nicht beschreibbaren Arbeitsspeicher zeigt.

Anforderungen

Weitere Informationen

GetAdapterCount

IDirect3D9