IMediaControl ::P ause, 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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 Pause méthode interrompt tous les filtres dans le graphe de filtre.

Syntaxe

HRESULT Pause();

Valeur de retour

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
S_FALSE
Le graphe s’est interrompu correctement, mais certains filtres n’ont pas terminé la transition d’état.
S_OK
Tous les filtres du graphique ont terminé la transition vers un état suspendu.

Remarques

La suspension du graphe de filtre indique le graphe pour un rendu immédiat lors de la prochaine exécution du graphe. Lorsque le graphe est suspendu, les filtres traitent les données, mais ne les restituent pas. Les données sont envoyées via le graphique et traitées par des filtres de transformation dans la mesure où la mise en mémoire tampon le permet, mais les filtres de renderer ne rendent pas les données. Toutefois, les convertisseurs vidéo affichent une image d’affiche statique du premier exemple.

Si la méthode retourne S_FALSE, appelez la méthode IMediaControl ::GetState pour attendre que la transition d’état se termine, ou pour case activée si la transition est terminée. Lorsque vous appelez Pause pour afficher la première image d’un fichier vidéo, suivez-le immédiatement avec un appel à GetState pour vous assurer que la transition d’état est terminée. Si vous ne le faites pas, le rectangle vidéo est peint en noir.

Si la méthode échoue, elle arrête le graphe avant de retourner.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête control.h (include Dshow.h)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IMediaControl Interface

IMediaControl ::StopWhenReady