Freigeben über


IMediaControl::Stop-Methode (control.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Stop -Methode beendet alle Filter im Diagramm.

Syntax

HRESULT Stop();

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Fehlerursache angibt.

Hinweise

Wenn der Graph ausgeführt wird, hält diese Methode den Graphen an, bevor es beendet wird. Während sie angehalten sind, können Videorender den aktuellen Frame kopieren, um als Posterrahmen anzuzeigen.

Diese Methode sucht nicht am Anfang des Datenstroms. Wenn Sie diese Methode aufrufen und dann die IMediaControl::Run-Methode aufrufen, wird die Wiedergabe von der beendeten Position fortgesetzt. Verwenden Sie zum Suchen die IMediaSeeking-Schnittstelle .

Der Filter Graph-Manager hält alle Filter im Graphen an und ruft dann die IMediaFilter::Stop-Methode für alle Filter auf, ohne darauf zu warten, dass die Pausenvorgänge abgeschlossen sind. Daher kann die Methode für einige Filter aufgerufen werden Stop , bevor sie den Pausenvorgang abschließen. Wenn Sie einen benutzerdefinierten Renderingfilter entwickeln, müssen Sie diesen Fall möglicherweise behandeln, indem Sie den Filter anhalten, wenn er einen Stop-Befehl empfängt, während er sich in einem aktiven Zustand befindet. Die meisten Filter müssen in dieser Hinsicht jedoch keine besonderen Maßnahmen ergreifen.

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

StopWhenReady