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

Notes

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

• EC_COMPLETE
• EC_ERRORABORT
• EC_USERABORT

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

Voir aussi

Codes d’erreur et de réussite

IMediaEvent, interface