IDXCoreAdapter::GetFactory-Methode
Ruft einen IDXCoreAdapterFactory-Schnittstellenzeiger auf das FACTORY-Objekt des DXCore-Adapters ab. Programmieranleitungen und Codebeispiele finden Sie unter Verwenden von DXCore zum Auflisten von Adaptern.
Syntax
virtual HRESULT STDMETHODCALLTYPE GetFactory(
REFIID riid,
_COM_Outptr_ void** ppvFactory
) = 0;
template <class T>
HRESULT GetFactory(_COM_Outptr_ T** 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.
ppvFactory [out]
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 das vorhandene FACTORY-Objekt des DXCore-Adapters. Vor der Rückgabe erhöht die Funktion die Verweisanzahl auf der IDXCoreAdapterFactory-Schnittstelle des Factoryobjekts.
Gibt zurück
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. |
Bemerkungen
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.
Siehe auch
IDXCoreAdapter, DXCore-Referenz, Verwenden von DXCore zum Auflisten von Adaptern
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für