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