Interface IMediaEvent (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 IMediaEvent contient des méthodes permettant de récupérer les notifications d’événements et de remplacer la gestion par défaut des événements du Gestionnaire de graphes de filtre. L’interface IMediaEventEx hérite de cette interface et l’étend.
Le Gestionnaire de graphes de filtre implémente cette interface. Les applications peuvent l’utiliser pour répondre aux événements qui se produisent dans le graphique de filtre, tels que la fin d’un flux ou une erreur de rendu. Filtre les événements de publication dans le graphe de filtre à l’aide de l’interface IMediaEventSink .
Pour plus d’informations sur la notification d’événement, consultez Notification d’événement dans DirectShow. Pour obtenir la liste des notifications d’événements définies par le système, consultez Codes de notification d’événement.
Héritage
L’interface IMediaEvent hérite de l’interface IDispatch. IMediaEvent a également les types de membres suivants :
Méthodes
L’interface IMediaEvent a ces méthodes.
| IMediaEvent ::CancelDefaultHandling La méthode CancelDefaultHandling annule la gestion par défaut du Gestionnaire de graphes de filtre pour un événement spécifié. La notification d’événement est passée à l’application. |
| IMediaEvent ::FreeEventParams La méthode FreeEventParams libère les ressources associées aux paramètres d’un événement. |
| IMediaEvent ::GetEvent La méthode GetEvent récupère la notification d’événement suivante à partir de la file d’attente d’événements. |
| IMediaEvent ::GetEventHandle La méthode GetEventHandle récupère un handle pour un événement de réinitialisation manuelle qui reste signalé pendant que la file d’attente contient des notifications d’événements. |
| IMediaEvent ::RestoreDefaultHandling La méthode RestoreDefaultHandling restaure la gestion par défaut du Gestionnaire de graphes de filtre pour un événement spécifié. |
| IMediaEvent ::WaitForCompletion La méthode WaitForCompletion attend que le graphe de filtre affiche toutes les données disponibles. Le graphe de filtre doit être en cours d’exécution ou la méthode échoue. |
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) |