Metodo IVideoWindow::p ut_MessageDrain (control.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il put_MessageDrain metodo specifica una finestra per ricevere i messaggi del mouse e della tastiera dalla finestra del video.

Sintassi

HRESULT put_MessageDrain(
  [in] OAHWND Drain
);

Parametri

[in] Drain

Handle per la finestra, come valore OAHWND .

Valore restituito

I valori restituiti possibili includono quanto segue:

Codice restituito Descrizione
S_OK
 Operazione completata.
VFW_E_NOT_CONNECTED
 Il filtro del renderer video non è connesso.

Commenti

Questo metodo consente a un'applicazione di rispondere agli eventi del mouse e della tastiera generati all'interno della finestra video.

Se Drain è diverso da NULL, il renderer video inoltra determinati messaggi alla finestra specificata, usando la funzione PostMessage . I messaggi inoltrati possono dipendere dal renderer video in uso. Il renderer video e il renderer di missaggio video (VMR) inoltrano i messaggi seguenti:

  • 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
La finestra di svuotamento dei messaggi non deve essere un elemento padre della finestra video, quindi le applicazioni a schermo intero possono usare questo metodo.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione control.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IVideoWindow

IVideoWindow::get_MessageDrain