IMFSourceReader::GetServiceForStream-Methode (mfreadwrite.h)

Artikel
03/01/2024

Fragt die zugrunde liegende Medienquelle oder den zugrunde liegenden Decoder für eine Schnittstelle ab.

Syntax

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

Parameter

[in] dwStreamIndex

Der abzufragende Stream oder das abzufragende Objekt. Wenn der Wert MF_SOURCE_READER_MEDIASOURCE ist, fragt die -Methode die Medienquelle ab. Andernfalls fragt er den Decoder ab, der dem angegebenen Stream zugeordnet ist. Die folgenden Werte sind möglich.

Wert	Bedeutung
0–0xFFFFFFFB	Der nullbasierte Index eines Datenstroms.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Der erste Audiodatenstrom.
MF_SOURCE_READER_MEDIASOURCE 0xFFFFFFFF	Die Medienquelle.

[in] guidService

Eine Dienstbezeichner-GUID. Wenn der Wert GUID_NULL ist, ruft die Methode QueryInterface auf, um die angeforderte Schnittstelle abzurufen. Andernfalls ruft die Methode die IMFGetService::GetService-Methode 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

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

IMFSourceReader

Dienstschnittstellen

Quellleser