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