MFGetService-Funktion (mfidl.h)

Fragt ein Objekt für eine angegebene Dienstschnittstelle ab.

Diese Funktion ist eine Hilfsfunktion, die die IMFGetService::GetService-Methode umschließt. Die Funktion fragt das Objekt nach der IMFGetService-Schnittstelle ab und ruft bei erfolgreicher Ausführung GetService für das Objekt auf.

Syntax

HRESULT MFGetService(
  IUnknown *punkObject,
  REFGUID  guidService,
  REFIID   riid,
  LPVOID   *ppvObject
);

punkObject

Ein Zeiger auf die IUnknown-Schnittstelle des abzufragenden Objekts.

guidService

Der Dienstbezeichner (SID) des Diensts. Eine Liste der Dienstbezeichner finden Sie unter Dienstschnittstellen.

riid

Der Schnittstellenbezeichner (IID) der angeforderten Schnittstelle.

ppvObject

Empfängt den Schnittstellenzeiger. Der Aufrufer muss die Schnittstelle freigeben.

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_UNSUPPORTED_SERVICE	Der angeforderte Dienst kann nicht in dem von punkObject dargestellten Objekt gefunden werden.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mf.lib
DLL	Mf.dll