Interface IQueueCommand (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.]

L’interface IQueueCommand met en file d’attente une commande pour traitement à un moment désigné. Le Gestionnaire de graphes de filtre expose cette interface. Les applications peuvent l’utiliser pour mettre en file d’attente des commandes de contrôle de graphique à l’avance.

Les méthodes dans IQueueCommand sont modélisées d’après la méthode IDispatch::InvokeAt . L’application spécifie une interface, une méthode sur l’interface, les paramètres de la méthode et une heure de référence. Le Gestionnaire de graphes de filtre met en file d’attente ces informations, puis appelle la méthode à l’heure spécifiée. L’interface demandée doit hériter d’IDispatch et doit être exposée par le Gestionnaire de graphes de filtre. Les exemples incluent IMediaControl, IMediaEventEx et IMediaPosition.

Lorsque la commande est mise en file d’attente, le gestionnaire de graphe de filtre retourne un pointeur vers l’interface IDeferredCommand . L’application peut utiliser cette interface pour annuler ou modifier la commande.

Note Les deux méthodes dans IQueueCommand font référence respectivement à l’heure du flux et à l’heure de présentation. Dans le contexte du Gestionnaire de graphes de filtre, le temps de diffusion et le temps de présentation sont identiques, il n’y a donc aucune différence fonctionnelle entre les deux méthodes. D’autres objets peuvent être implémentés IQueueCommand différemment. Pour plus d’informations sur l’heure du flux et l’heure de présentation, consultez Heure et horloges dans DirectShow.

 

Héritage

L’interface IQueueCommand hérite de l’interface IUnknown. IQueueCommand a également les types de membres suivants :

Méthodes

L’interface IQueueCommand possède ces méthodes.

IQueueCommand::InvokeAtPresentationTime La méthode InvokeAtPresentationTime met en file d’attente une méthode à appeler à l’heure de présentation spécifiée.
IQueueCommand::InvokeAtStreamTime La méthode InvokeAtStreamTime met en file d’attente une modification de méthode ou de propriété pour l’exécution à une heure de flux spécifiée (c’est-à-dire, l’heure de présentation par rapport au décalage actuel du temps de flux).

Configuration requise

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)