IDXCoreAdapter::GetFactory-Methode
Ruft einen IDXCoreAdapterFactory-Schnittstellenzeiger auf das DXCore-Adapterfactoryobjekt ab. Programmieranleitungen und Codebeispiele finden Sie unter Using DXCore to enumerate adapters(Verwenden von DXCore zum Aufzählen 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 die GUID (Globally Unique Identifier) der Schnittstelle, die in ppvFactory zurückgegeben werden soll. Es wird erwartet, dass dies der Schnittstellenbezeichner (IID) von IDXCoreAdapterFactory ist.
ppvFactory [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 * ppvFactory (die dereferenzierte Adresse) einen Zeiger auf das vorhandene DXCore-Adapterfactoryobjekt. Vor der Rückgabe erhöht die Funktion den Verweiszähler für die IDXCoreAdapterFactory-Schnittstelle des Factoryobjekts.
Rückgabe
Typ: HRESULT
Wenn die Funktion erfolgreich ist, gibt sie S_OK. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabewert | BESCHREIBUNG |
|---|---|
| E_NOINTERFACE | Für riid wurde ein ungültiger Wert bereitgestellt. |
| E_POINTER | nullptrwurde für ppvFactory bereitgestellt. |
Bemerkungen
Für die Dauer, für die ein Verweis auf einer IDXCoreAdapterFactory-Schnittstelle, einer IDXCoreAdapterList-Schnittstelle oder einer IDXCoreAdapter-Schnittstelle vorhanden ist, geben zusätzliche Aufrufe von DXCoreCreateAdapterFactory, IDXCoreAdapterList::GetFactoryoder IDXCoreAdapter::GetFactory Zeiger auf dasselbe Objekt zurück, was die Verweisanzahl der IDXCoreAdapterFactory-Schnittstelle erhöht.
Weitere Informationen
IDXCoreAdapter, DXCore-Referenz, Verwenden von DXCore zum Aufzählen von Adaptern