IMFSinkWriter::GetServiceForStream-Methode (mfreadwrite.h)
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 |