IMFMediaEventGenerator ::GetEvent, méthode (mfobjects.h)
Récupère l’événement suivant dans la file d’attente. Cette méthode est synchrone.
Syntaxe
HRESULT GetEvent(
[in] DWORD dwFlags,
[out] IMFMediaEvent **ppEvent
);
Paramètres
[in] dwFlags
Spécifie l’une des valeurs suivantes.
Valeur | Signification |
---|---|
|
La méthode se bloque jusqu’à ce que le générateur d’événements met en file d’attente un événement. |
|
La méthode retourne immédiatement. |
[out] ppEvent
Reçoit un pointeur vers l’interface IMFMediaEvent . L’appelant doit libérer l’interface.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
Code de retour | Description |
---|---|
|
S_OK |
|
Argument pointeur NULL. |
|
Une demande est en attente. |
|
Il n’y a aucun événement dans la file d’attente. |
|
L’objet a été arrêté. |
Remarques
Cette méthode s’exécute de manière synchrone.
Si la file d’attente contient déjà un événement, la méthode retourne immédiatement S_OK. Si la file d’attente ne contient pas d’événement, le comportement dépend de la valeur de dwFlags :
- Si dwFlags a la valeur 0, la méthode se bloque indéfiniment jusqu’à ce qu’un nouvel événement soit mis en file d’attente, ou jusqu’à ce que le générateur d’événements soit arrêté.
- Si dwFlags est MF_EVENT_FLAG_NO_WAIT, la méthode échoue immédiatement avec le code de retour MF_E_NO_EVENTS_AVAILABLE.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
Plateforme cible | Windows |
En-tête | mfobjects.h (include Mfidl.h) |
Bibliothèque | Mfuuid.lib |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour