IMFMediaSource::P ause-Methode (mfidl.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Ungültiger Zustandsübergang. Die Medienquelle muss sich im Startzustand befinden. |
|
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 |