IMFPMediaItem::SetStreamSink-Methode (mfplay.h)
Legt eine Mediensenke für das Medienelement fest. Eine Mediensenke ist ein Objekt, das die Daten aus einem oder mehreren Streams nutzt.
Syntax
HRESULT SetStreamSink(
[in] DWORD dwStreamIndex,
[in] IUnknown *pMediaSink
);
Parameter
[in] dwStreamIndex
Nullbasierter Index eines Datenstroms für die Medienquelle. Die Mediensenke empfängt die Daten aus diesem Stream.
[in] pMediaSink
IUnknown-Zeiger , der die Mediensenke angibt. Übergeben Sie eine der folgenden Optionen:
- Ein Zeiger auf eine Streamsenke. Jede Mediensenke enthält mindestens eine Streamsenke. Jede Streamsenke empfängt die Daten aus einem Stream. Die Streamsenke muss die IMFStreamSink-Schnittstelle verfügbar machen.
- Ein Zeiger auf ein Aktivierungsobjekt, das die Mediensenke erstellt. Das Aktivierungsobjekt muss die IMFActivate-Schnittstelle verfügbar machen. Das Medienelement verwendet die erste Streamsenke auf der Mediensenke (also die Streamsenke bei Index 0).
- NULL. Wenn Sie pMediaSink auf NULL festlegen, wird die Standardmediensenke für den Streamtyp verwendet.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Standardmäßig rendert das MFPlay-Playerobjekt Audiostreams an den Streaming Audio Renderer (SAR) und Videostreams an den erweiterten Videorenderer (EVR ). Sie können die SetStreamSink-Methode verwenden, um eine andere Mediensenke für einen Audio- oder Videostream bereitzustellen. oder andere Streamtypen neben Audio und Video zu unterstützen. Sie können es auch verwenden, um die SAR oder EVR zu konfigurieren, bevor sie verwendet werden.
Rufen Sie diese Methode auf, bevor Sie IMFPMediaPlayer::SetMediaItem aufrufen. Das Aufrufen dieser Methode nach SetMediaItem hat keine Auswirkung, es sei denn, Sie beenden die Wiedergabe und rufen SetMediaItem erneut auf.
Um das Medienelement auf die Verwendung der Standardmediensenke zurückzusetzen, legen Sie pMediaSink auf NULL fest.
Optimierungen der Remotewiedergabe
Wenn die Anwendung über Remotedesktop ausgeführt wird und Sie diese Methode mit einem Wert ungleich NULL für einen Audio- oder Videostream aufrufen, deaktiviert MFPlay Remotewiedergabeoptimierungen. Diese Bemerkung gilt nur für Audio- und Videostreams. Sie gilt nicht für Datenströme, die einen anderen Datentyp enthalten, z. B. Text.Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | mfplay.h |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für