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.

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