Método IVideoWindow::p ut_MessageDrain (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 put_MessageDrain método especifica uma janela para receber mensagens de mouse e teclado da janela de vídeo.

Sintaxe

HRESULT put_MessageDrain(
  [in] OAHWND Drain
);

Parâmetros

[in] Drain

Um identificador para a janela, como um valor OAHWND .

Retornar valor

Os possíveis valores retornados incluem o seguinte:

Código de retorno Descrição
S_OK
 Êxito.
VFW_E_NOT_CONNECTED
 O filtro do renderizador de vídeo não está conectado.

Comentários

Esse método permite que um aplicativo responda a eventos de mouse e teclado gerados dentro da janela de vídeo.

Se Drain não for NULL, o renderizador de vídeo encaminhará determinadas mensagens para a janela especificada, usando a função PostMessage . Quais mensagens são encaminhadas podem depender do renderizador de vídeo em uso. O Renderizador de Vídeo e o VMR (Renderizador de Combinação de Vídeo) filtram as seguintes mensagens:

  • WM_CHAR
  • WM_DEADCHAR
  • WM_KEYDOWN
  • WM_KEYUP
  • WM_LBUTTONDBLCLK
  • WM_LBUTTONDOWN
  • WM_LBUTTONUP
  • WM_MBUTTONDBLCLK
  • WM_MBUTTONDOWN
  • WM_MBUTTONUP
  • WM_MOUSEACTIVATE
  • WM_MOUSEMOVE
  • WM_NCLBUTTONDBLCLK
  • WM_NCLBUTTONDOWN
  • WM_NCLBUTTONUP
  • WM_NCMBUTTONDBLCLK
  • WM_NCMBUTTONDOWN
  • WM_NCMBUTTONUP
  • WM_NCMOUSEMOVE
  • WM_NCRBUTTONDBLCLK
  • WM_NCRBUTTONDOWN
  • WM_NCRBUTTONUP
  • WM_RBUTTONDBLCLK
  • WM_RBUTTONDOWN
  • WM_RBUTTONUP
  • WM_SYSCHAR
  • WM_SYSDEADCHAR
  • WM_SYSKEYDOWN
  • WM_SYSKEYUP
A janela esvaziar mensagens não precisa ser um pai da janela de vídeo, portanto, aplicativos de tela inteira podem usar esse método.

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

IVideoWindow Interface

IVideoWindow::get_MessageDrain