Méthode ICaptureGraphBuilder::ControlStream (strmif.h)

Article
07/28/2023

[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.]

NoteL’interface ICaptureGraphBuilder est déconseillée. Utilisez ICaptureGraphBuilder2 à la place.

Envoie des messages de contrôle de flux à l’épingle de la catégorie spécifiée sur un ou plusieurs filtres de capture dans un graphique.

Syntaxe

HRESULT ControlStream(
  [in] const GUID     *pCategory,
  [in] IBaseFilter    *pFilter,
  [in] REFERENCE_TIME *pstart,
  [in] REFERENCE_TIME *pstop,
  [in] WORD           wStartCookie,
  [in] WORD           wStopCookie
);

Paramètres

[in] pCategory

Pointeur vers un GUID spécifiant la catégorie de broche de sortie. Consultez Pin Property Set pour obtenir la liste de toutes les catégories d’épingles. Cette valeur ne peut pas être NULL.

[in] pFilter

Pointeur vers une interface IBaseFilter sur le filtre à contrôler. La spécification de la valeur NULL contrôle tous les filtres de capture dans le graphique. Vous recevrez une notification pour chaque filtre de capture.

[in] pstart

Pointeur vers l’heure de début de la capture. NULL signifie démarrer maintenant. MAX_TIME signifie annuler la demande précédente ou n’effectuer aucune action s’il n’y a pas de requête précédente.

[in] pstop

Pointeur vers l’heure d’arrêt de la capture. NULL signifie arrêter maintenant. MAX_TIME signifie annuler la demande précédente ou n’effectuer aucune action s’il n’y a pas de requête précédente.

[in] wStartCookie

Spécifie une valeur particulière à envoyer lorsque le démarrage se produit.

[in] wStopCookie

Spécifie une valeur particulière à envoyer lorsque l’arrêt se produit.

Valeur renvoyée

Retourne S_FALSE si la notification d’arrêt est envoyée avant le rendu du dernier exemple envoyé par le filtre de capture, sinon retourne S_OK.

Si cette méthode retourne S_FALSE, l’application peut souhaiter attendre avant d’arrêter le graphique de filtre pour permettre à tous les exemples de passer dans le graphe et d’être affichés. Sinon, des échantillons risquent d’être perdus.

Si aucune broche ne correspond à la description que vous fournissez, ou si le contrôle de flux ne peut pas être pris en charge sur toutes les broches indiquées, cette fonction retourne un code d’échec.

Notes

Utilisez cette méthode pour la capture précise de l’image ou pour le contrôle individuel de la capture et de l’aperçu. Par exemple, vous pouvez désactiver l’écriture de l’image capturée sur le disque si vous souhaitez uniquement afficher un aperçu de l’image capturée.

Cette méthode utilise l’interface IAMStreamControl sur les broches.

Cette méthode envoie une notification pour chaque filtre trouvé avec une épingle de la catégorie spécifiée.

Configuration requise


Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)

Voir aussi

Codes d’erreur et de réussite

ICaptureGraphBuilder, interface

Partager via