IMFMediaSource::P ause-Methode (mfidl.h)

  • Artikel

Hält alle aktiven Streams in der Medienquelle an.

Syntax

HRESULT Pause();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALID_STATE_TRANSITION
 Ungültiger Zustandsübergang. Die Medienquelle muss sich im Startzustand befinden.
MF_E_SHUTDOWN
 Die Shutdown-Methode der Medienquelle wurde aufgerufen.

Hinweise

Diese Methode ist asynchron. Wenn der Vorgang abgeschlossen ist, sendet die Medienquelle und das MESourcePaused-Ereignis , und jeder aktive Stream sendet ein MEStreamPaused-Ereignis . Wenn die Methode einen Fehlercode zurückgibt, werden keine Ereignisse ausgelöst.

Die Medienquelle muss sich im Startzustand befinden. Die -Methode schlägt fehl, wenn die Medienquelle angehalten oder beendet wird.

Während die Quelle angehalten ist, sind Aufrufe von IMFMediaStream::RequestSample erfolgreich, aber die Streams liefern erst nach dem erneuten Starten der Quelle beispiele. Beachten Sie, dass die Ereigniswarteschlange der Quelle nicht mit den Streamereigniswarteschlangen serialisiert wird, sodass der Client aufgrund von Multithreadingproblemen möglicherweise einige Beispiele nach dem MESourcePaused-Ereignis empfängt . Der Client empfängt jedoch nach dem MEStreamPaused-Ereignis keine Beispiele aus einem Stream.

Nicht jede Medienquelle kann angehalten werden. Wenn eine Medienquelle angehalten werden kann, gibt die IMFMediaSource::GetCharacteristics-Methode das flag MFMEDIASOURCE_CAN_PAUSE zurück.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaSource

Medienquellen