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

  • Artigo

Recupera o próximo evento na fila. Esse método é síncrono.

Sintaxe

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

Parâmetros

[in] dwFlags

Especifica um dos valores a seguir.

Valor Significado
0
 O método bloqueia até que o gerador de eventos enfileira um evento.
MF_EVENT_FLAG_NO_WAIT
 O método retorna imediatamente.

[out] ppEvent

Recebe um ponteiro para a interface IMFMediaEvent . O chamador deve liberar a interface.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 Argumento de ponteiro NULL.
MF_E_MULTIPLE_SUBSCRIBERS
 Há uma solicitação pendente.
MF_E_NO_EVENTS_AVAILABLE
 Não há eventos na fila.
MF_E_SHUTDOWN
 O objeto foi desligado.

Comentários

Esse método é executado de forma síncrona.

Se a fila já contiver um evento, o método retornará S_OK imediatamente. Se a fila não contiver um evento, o comportamento dependerá do valor de dwFlags:

  • Se dwFlags for 0, o método será bloqueado indefinidamente até que um novo evento seja enfileirado ou até que o gerador de eventos seja desligado.
  • Se dwFlags for MF_EVENT_FLAG_NO_WAIT, o método falhará imediatamente com o código de retorno MF_E_NO_EVENTS_AVAILABLE.
Esse método retornará MF_E_MULTIPLE_SUBSCRIBERS se você tiver chamado IMFMediaEventGenerator::BeginGetEvent e ainda não tiver chamado IMFMediaEventGenerator::EndGetEvent.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFMediaEventGenerator

Geradores de Eventos de Mídia