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

  • Artículo

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