DXCoreCreateAdapterFactory-Funktion
BESCHREIBUNG
Erstellt eine DXCore-Adapterfactory, mit der Sie weitere DXCore-Objekte generieren können. Programmierleitfäden und Codebeispiele finden Sie unter Verwenden von DXCore zum Aufzählen von Adaptern.
Parameter
riid
Typ: REFIID
Ein Verweis auf die GUID (Globally Unique Identifier) der Schnittstelle, die in ppvFactory zurückgegeben werden soll. Es wird erwartet, dass dies der Schnittstellenbezeichner (IID) von IDXCoreAdapterFactoryist.
ppvFactory [out]
Typ: * * void
Die Adresse eines Zeigers auf eine Schnittstelle mit der im riid-Parameter angegebenen IID. Nach erfolgreicher Rückgabe enthält * ppvFactory (die dereferenzierte Adresse) einen Zeiger auf die erstellte DXCore-Factory.
Rückgabe
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. 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. |
Bemerkungen
Für den Zeitraum, in dem ein Verweis auf eine IDXCoreAdapterFactory-Schnittstelle, eine IDXCoreAdapterList-Schnittstelle oder eine IDXCoreAdapter-Schnittstelle vorhanden ist, geben zusätzliche Aufrufe von DXCoreCreateAdapterFactory, IDXCoreAdapterList::GetFactoryoder IDXCoreAdapter::GetFactory Zeiger auf dasselbe Objekt zurück, wodurch die Verweisanzahl der IDXCoreAdapterFactory-Schnittstelle erhöht wird.
Weitere Informationen
DXCore-Referenz: Verwenden von DXCore zum Aufzählen von Adaptern