IMFSinkWriter::GetServiceForStream-Methode (mfreadwrite.h)

  • Artikel

Fragt die zugrunde liegende Mediensenke oder den zugrunde liegenden Encoder für eine Schnittstelle ab.

Syntax

HRESULT GetServiceForStream(
  [in]  DWORD   dwStreamIndex,
  [in]  REFGUID guidService,
  [in]  REFIID  riid,
  [out] LPVOID  *ppvObject
);

Parameter

[in] dwStreamIndex

Der nullbasierte Index eines abzufragenden Datenstroms oder MF_SINK_WRITER_MEDIASINK , um die Mediensenke selbst abzufragen.

[in] guidService

Eine Dienstbezeichner-GUID oder GUID_NULL. Wenn der Wert GUID_NULL ist, ruft die Methode QueryInterface auf, um die angeforderte Schnittstelle abzurufen. Andernfalls ruft die Methode IMFGetService::GetService auf. Eine Liste der Dienstbezeichner finden Sie unter Dienstschnittstellen.

[in] riid

Der Schnittstellenbezeichner (Interface Identifier, IID) der angeforderten Schnittstelle.

[out] ppvObject

Empfängt einen Zeiger auf die angeforderte Schnittstelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der dwStreamIndex-Parametergleich MF_SINK_WRITER_MEDIASINK ist, versucht die Methode, die Schnittstelle aus der Mediensenke abzurufen. Andernfalls wird versucht, die Schnittstelle vom Encoder für den Stream am angegebenen Index abzurufen. Wenn dies fehlschlägt oder kein Encoder vorhanden ist, versucht die Methode, die Schnittstelle aus dem Datenstrom auf der Mediensenke abzurufen.

Wenn die Eingabe- und Ausgabetypen der Senke identisch und komprimiert sind, ist möglicherweise keine Codierung erforderlich, und der Videoencoder wird nicht instanziiert. In diesem Fall gibt GetServiceForStream MF_E_UNSUPPORTED_SERVICE zurück.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn das Plattformupdate-Supplement für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Ergänzung zu Windows 7, Windows Vista und Plattformupdates für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfreadwrite.h

Weitere Informationen

IMFSinkWriter

Sink Writer