Méthode IMediaEvent::WaitForCompletion (control.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.]

La WaitForCompletion méthode attend que le graphique de filtre affiche toutes les données disponibles. Le graphe de filtre doit être en cours d’exécution ou la méthode échoue.

Syntaxe

HRESULT WaitForCompletion(
  [in]  long msTimeout,
  [out] long *pEvCode
);

Paramètres

[in] msTimeout

Intervalle de délai d’attente, en millisecondes. Passez zéro pour revenir immédiatement. Transmettez la valeur INFINITE à bloquer indéfiniment.

[out] pEvCode

Pointeur vers une variable qui reçoit un code d’événement. Pour plus d'informations, consultez la section Notes.

Valeur renvoyée

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

Code de retour	Description
S_OK	Opération réussie.
E_ABORT	Le délai d’attente a expiré.
VFW_E_WRONG_STATE	Le graphique de filtre n’est pas en cours d’exécution.

Notes

Cette méthode se bloque jusqu’à ce que le délai d’expiration expire, ou l’un des événements suivants se produit :

Pendant l’attente, la méthode ignore toutes les autres notifications d’événements.

Si la valeur de retour est S_OK, le paramètre pEvCode reçoit le code d’événement qui a mis fin à l’attente. Lorsque la méthode est retournée, le graphique de filtre est toujours en cours d’exécution. L’application peut suspendre ou arrêter le graphique, le cas échéant.

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)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IMediaEvent, interface

Partager via