IMediaControl ::Stop, méthode (control.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La Stop méthode arrête tous les filtres du graphique.

Syntaxe

HRESULT Stop();

Valeur de retour

Retourne S_OK en cas de réussite, ou une valeur HRESULT qui indique la cause de l’erreur.

Remarques

Si le graphique est en cours d’exécution, cette méthode suspend le graphique avant de l’arrêter. En pause, les convertisseurs vidéo peuvent copier l’image actuelle pour l’afficher en tant que cadre d’affiche.

Cette méthode ne cherche pas au début du flux. Si vous appelez cette méthode, puis la méthode IMediaControl ::Run , la lecture reprend à partir de la position arrêtée. Pour rechercher, utilisez l’interface IMediaSeeking .

Le Gestionnaire de graphe de filtres met en pause tous les filtres dans le graphique, puis appelle la méthode IMediaFilter ::Stop sur tous les filtres, sans attendre que les opérations de pause se terminent. Par conséquent, leur méthode peut être Stop appelée pour certains filtres avant d’effectuer leur opération de pause. Si vous développez un filtre de rendu personnalisé, vous devrez peut-être gérer ce cas en suspendant le filtre s’il reçoit une commande d’arrêt alors qu’il est en cours d’exécution. Toutefois, la plupart des filtres n’ont pas besoin d’effectuer une action particulière à cet égard.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IMediaControl, interface

StopWhenReady