IMFPMediaItem::SetStreamSink-Methode (mfplay.h)

  • Artikel
Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.
 

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

IMFPMediaItem

Mediensenken

Verwenden von MFPlay für die Audio-/Videowiedergabe