Método IMediaEvent::FreeEventParams (control.h)

  • Artigo

[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 FreeEventParams método libera recursos associados aos parâmetros de um evento.

Sintaxe

HRESULT FreeEventParams(
  [in] long     lEvCode,
  [in] LONG_PTR lParam1,
  [in] LONG_PTR lParam2
);

Parâmetros

[in] lEvCode

Código de evento.

[in] lParam1

Primeiro parâmetro de evento.

[in] lParam2

Segundo parâmetro de evento.

Retornar valor

Returns S_OK.

Comentários

Depois de chamar o método IMediaEvent::GetEvent para recuperar uma notificação de evento, você deve chamar FreeEventParams. Esse método libera todos os recursos que foram alocados para os parâmetros de evento. Passe as mesmas variáveis usadas para a chamada GetEvent .

Exemplos


hr = pEvent->GetEvent(&evCode, &param1, &param2, 0);
// Handle the event (not shown). 
hr = pEvent->FreeEventParams(evCode, param1, param2);

Requisitos

   
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

IMediaEvent Interface

Imediaeventex