IDXCoreAdapterFactory::GetAdapterByLuid-Methode

Ruft das DXCore-Adapterobjekt (IDXCoreAdapter) für eine angegebene LUID ab, falls verfügbar. Programmieranleitungen und Codebeispiele finden Sie unter Using DXCore to enumerate adapters(Verwenden von DXCore zum Aufzählen von Adaptern).

Syntax

virtual HRESULT STDMETHODCALLTYPE GetAdapterByLuid( 
  const LUID &adapterLUID,
   REFIID riid,
  _COM_Outptr_ void **ppvAdapter) = 0;

template<class T>
HRESULT STDMETHODCALLTYPE GetAdapterByLuid( 
  const LUID &adapterLUID,
  _COM_Outptr_ T **ppvAdapter);

Parameter

adapterLUID

Typ: LUID const&

Der lokal eindeutige Wert, der die Adapterinstanz identifiziert.

riid [in]

Typ: REFIID

Ein Verweis auf die GUID (Globally Unique Identifier) der Schnittstelle, die in ppvAdapter zurückgegeben werden soll. Es wird erwartet, dass dies der Schnittstellenbezeichner (IID) von IDXCoreAdapter ist.

ppvAdapter [out]

Typ: * * void

Die Adresse eines Zeigers auf eine Schnittstelle mit der IID, die im riid-Parameter angegeben ist. Nach erfolgreicher Rückgabe enthält * ppvAdapter (die dereferenzierte Adresse) einen Zeiger auf den erstellten DXCore-Adapter.

Rückgabe

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabewert BESCHREIBUNG
DXGI_ERROR_DEVICE_REMOVED Die in adapterLUID übergebene Adapter-LUID wird erkannt, aber der Adapter befindet sich nicht mehr in einem gültigen Zustand.
E_INVALIDARG Es ist keine solche Adapter-LUID verfügbar, da der in adapterLUID übergebene Wert über DXCore verfügbar ist.
E_NOINTERFACE Für riid wurde ein ungültiger Wert bereitgestellt.
E_POINTER nullptrwurde für ppvAdapter bereitgestellt.

Bemerkungen

Mehrere Aufrufe, die dieselbe LUID übergeben, geben identische Schnittstellenzeige zurück. Daher ist es sicher, Schnittstellenzeker zu vergleichen, um zu bestimmen, ob mehrere Zeiger auf das gleiche Adapterobjekt verweisen.

Weitere Informationen

IDXCoreAdapterFactory, DXCore-Referenz, Verwenden von DXCore zum Aufzählen von Adaptern