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 |