Método IMFMediaEventGenerator::GetEvent (mfobjects.h)
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 |
---|---|
|
O método bloqueia até que o gerador de eventos enfileira um evento. |
|
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 |
---|---|
|
O método foi bem-sucedido. |
|
Argumento de ponteiro NULL. |
|
Há uma solicitação pendente. |
|
Não há eventos na fila. |
|
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.
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 |