DXCoreCreateAdapterFactory-Funktion (dxcore.h)

Erstellt eine DXCore-Adapterfactory, mit der Sie weitere DXCore-Objekte generieren können. Programmieranleitungen und Codebeispiele finden Sie unter Verwenden von DXCore zum Auflisten von Adaptern.

Syntax

HRESULT DXCoreCreateAdapterFactory(
        REFIID riid,
  [out] void   **ppvFactory
);

Parameter

riid

Typ: REFIID

Ein Verweis auf den Globally Unique Identifier (GUID) der Schnittstelle, die in ppvFactory zurückgegeben werden soll. Hierbei handelt es sich voraussichtlich um den Schnittstellenbezeichner (Interface Identifier, IID) von IDXCoreAdapterFactory.

[out] ppvFactory

Typ: void**

Die Adresse eines Zeigers auf eine Schnittstelle mit dem im riid-Parameter angegebenen IID. Nach erfolgreicher Rückgabe enthält *ppvFactory (die abgeleitete Adresse) einen Zeiger auf die erstellte DXCore-Factory.

Rückgabewert

Typ: HRESULT

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

Rückgabewert	BESCHREIBUNG
E_NOINTERFACE	Für riid wurde ein ungültiger Wert bereitgestellt.
E_POINTER	nullptr wurde für ppvFactory bereitgestellt.

Hinweise

Für die Dauer, für die ein Verweis auf eine IDXCoreAdapterFactory-Schnittstelle , eine IDXCoreAdapterList-Schnittstelle oder eine IDXCoreAdapter-Schnittstelle vorhanden ist, geben zusätzliche Aufrufe von DXCoreCreateAdapterFactory, IDXCoreAdapterList::GetFactory oder IDXCoreAdapter::GetFactory Zeiger auf dasselbe Objekt zurück, wodurch die Verweisanzahl der IDXCoreAdapterFactory-Schnittstelle erhöht wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10 (Build 18936)
Zielplattform	Windows
Kopfzeile	dxcore.h
Bibliothek	dxcore.lib
DLL	dxcore.dll

Weitere Informationen

DXCore-Referenz: Verwenden von DXCore zum Auflisten von Adaptern