Método IMFMediaEventGenerator::GetEvent (mfobjects.h)

Recupera el siguiente evento de la cola. Este método es sincrónico.

Sintaxis

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

Parámetros

[in] dwFlags

Especifica uno de los valores siguientes.

Valor	Significado
0	El método se bloquea hasta que el generador de eventos pone en cola un evento.
MF_EVENT_FLAG_NO_WAIT	El método devuelve inmediatamente.

[out] ppEvent

Recibe un puntero a la interfaz IMFMediaEvent . El autor de la llamada debe liberar la interfaz .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	Argumento de puntero NULL.
MF_E_MULTIPLE_SUBSCRIBERS	Hay una solicitud pendiente.
MF_E_NO_EVENTS_AVAILABLE	No hay ningún evento en la cola.
MF_E_SHUTDOWN	El objeto se cerró.

Comentarios

Este método se ejecuta sincrónicamente.

Si la cola ya contiene un evento, el método devuelve S_OK inmediatamente. Si la cola no contiene un evento, el comportamiento depende del valor de dwFlags:

• Si dwFlags es 0, el método se bloquea indefinidamente hasta que se pone en cola un nuevo evento o hasta que se cierra el generador de eventos.
• Si dwFlags es MF_EVENT_FLAG_NO_WAIT, el método produce un error inmediatamente con el código de retorno MF_E_NO_EVENTS_AVAILABLE.

Este método devuelve MF_E_MULTIPLE_SUBSCRIBERS si anteriormente llamó a IMFMediaEventGenerator::BeginGetEvent y aún no ha llamado a IMFMediaEventGenerator::EndGetEvent.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfobjects.h (include Mfidl.h)
Library	Mfuuid.lib

Consulte también

IMFMediaEventGenerator

Generadores de eventos multimedia