Compartilhar via


Método IMediaEventEx::SetNotifyFlags (control.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetNotifyFlags método habilita ou desabilita as notificações de evento.

Sintaxe

HRESULT SetNotifyFlags(
  [in] long lNoNotifyFlags
);

Parâmetros

[in] lNoNotifyFlags

Valor que indica se as notificações de eventos devem ser habilitados ou desabilitados. Deve ser um dos seguintes valores:

Valor Descrição
Zero Habilitar notificações de eventos.
AM_MEDIAEVENT_NONOTIFY Desabilitar notificações de eventos.

Retornar valor

Retorna S_OK se tiver êxito ou E_INVALIDARG se o parâmetro lNoNotifyFlags for inválido.

Comentários

Por padrão, o Gerenciador de Grafo de Filtro posta notificações de eventos para o aplicativo. Se o parâmetro lNoNotifyFlags for AM_MEDIAEVENT_NONOTIFY, o Gerenciador do Gráfico de Filtros limpará as notificações de eventos pendentes da fila e não postará novas.

Se as notificações de eventos estiverem desabilitadas, o identificador retornado pelo método IMediaEvent::GetEventHandle será sinalizado no final de cada fluxo, ou seja, sempre que o Gerenciador do Gráfico de Filtro receber um evento EC_COMPLETE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho control.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IMediaEventEx Interface