Partager via


EC_COMPLETE

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

Toutes les données d’un flux particulier ont été rendues.

Paramètres

lParam1

(HRESULT) État du flux à l’achèvement. Si aucune erreur ne s’est produite pendant la lecture, la valeur est S_OK.

lParam2

(IUnknown*) Zéro ou pointeur vers l’interface IBaseFilter du convertisseur.

Action par défaut

Par défaut, le gestionnaire de graphe de filtres ne transfère pas cet événement à l’application. Toutefois, après tous les flux dans le rapport de graphique EC_COMPLETE, le gestionnaire de graphe de filtre publie un événement EC_COMPLETE distinct dans l’application.

Si l’action par défaut est désactivée pour cet événement, l’application reçoit tous les événements EC_COMPLETE des renderers.

Notes

Un filtre de renderer envoie cet événement lorsqu’il reçoit une notification de fin de flux. (La fin du flux est signalée via la méthode IPin::EndOfStream .) Le filtre envoie exactement un événement EC_COMPLETE pour chaque flux. Le filtre doit traiter tous les exemples en attente avant d’envoyer l’événement. L’arrêt d’un renderer réinitialise tout état de fin de flux mis en cache.

Si le convertisseur est suspendu, il n’envoie pas de EC_COMPLETE tant que la méthode IMediaFilter::Run n’est pas appelée. En outre, il continue d’envoyer des événements EC_COMPLETE pour chaque transition de la pause à l’exécution, jusqu’à ce que le filtre soit arrêté ou vidé.

Les filtres définissent le paramètre lParam2 sur un pointeur IBaseFilter . Si l’action par défaut est activée, le gestionnaire de graphe de filtre définit ce paramètre sur zéro.

Configuration requise

Condition requise Valeur
En-tête
Dshow.h

Voir aussi

Codes de notification d’événement

Notification d’événement dans DirectShow

Convertisseurs vidéo alternatifs