IDXCoreAdapterList::GetFactory-Methode

Ruft einen IDXCoreAdapterFactory-Schnittstellenzeiger auf das DXCore-Adapterfactoryobjekt ab. Programmierleitfäden und Codebeispiele finden Sie unter 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 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 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, 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

IDXCoreAdapterList, DXCore-Referenz, Verwenden von DXCore zum Auflisten von Adaptern