Freigeben über


IMediaControl::P ause-Methode (control.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die Pause -Methode hält alle Filter im Filterdiagramm an.

Syntax

HRESULT Pause();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_FALSE
Das Diagramm wurde erfolgreich angehalten, aber einige Filter haben den Zustandsübergang nicht abgeschlossen.
S_OK
Alle Filter im Diagramm haben den Übergang zu einem angehaltenen Zustand abgeschlossen.

Hinweise

Das Anhalten des Filterdiagramms weist das Diagramm zum sofortigen Rendern bei der nächsten Ausführung des Graphen auf. Während das Diagramm angehalten wird, verarbeiten Filter Daten, rendern sie jedoch nicht. Daten werden durch das Diagramm gepusht und von Transformationsfiltern verarbeitet, soweit die Pufferung dies zulässt, aber Rendererfilter rendern die Daten nicht. Videorenderer zeigen jedoch einen statischen Posterrahmen des ersten Beispiels an.

Wenn die Methode S_FALSE zurückgibt, rufen Sie die IMediaControl::GetState-Methode auf, um auf den Abschluss des Zustandsübergangs zu warten oder zu überprüfen, ob der Übergang abgeschlossen ist. Wenn Sie aufrufen Pause , um den ersten Frame einer Videodatei anzuzeigen, folgen Sie diesem immer sofort mit einem Aufruf von GetState , um sicherzustellen, dass der Zustandsübergang abgeschlossen ist. Wenn dies nicht geschieht, kann dies dazu führen, dass das Videorechteck schwarz dargestellt wird.

Wenn die Methode fehlschlägt, wird das Diagramm beendet, bevor sie zurückgegeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile control.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMediaControl-Schnittstelle

IMediaControl::StopWhenReady