IMFMediaEventGenerator ::GetEvent, méthode (mfobjects.h)

  • Article

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
0
 La méthode se bloque jusqu’à ce que le générateur d’événements met en file d’attente un événement.
MF_EVENT_FLAG_NO_WAIT
 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
 S_OK
E_INVALIDARG
 Argument pointeur NULL.
MF_E_MULTIPLE_SUBSCRIBERS
 Une demande est en attente.
MF_E_NO_EVENTS_AVAILABLE
 Il n’y a aucun événement dans la file d’attente.
MF_E_SHUTDOWN
 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.
Cette méthode retourne MF_E_MULTIPLE_SUBSCRIBERS si vous avez précédemment appelé IMFMediaEventGenerator ::BeginGetEvent et que vous n’avez pas encore appelé IMFMediaEventGenerator ::EndGetEvent.

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

IMFMediaEventGenerator

Générateurs d’événements multimédias