IVideoWindow::p ut_MessageDrain-Methode (control.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die put_MessageDrain -Methode gibt ein Fenster zum Empfangen von Maus- und Tastaturnachrichten aus dem Videofenster an.

Syntax

HRESULT put_MessageDrain(
  [in] OAHWND Drain
);

Parameter

[in] Drain

Ein Handle für das Fenster als OAHWND-Wert .

Rückgabewert

Folgende Rückgabewerte sind möglich:

Rückgabecode Beschreibung
S_OK
Erfolg.
VFW_E_NOT_CONNECTED
Der Videorendererfilter ist nicht verbunden.

Bemerkungen

Mit dieser Methode kann eine Anwendung auf Maus- und Tastaturereignisse reagieren, die im Videofenster generiert werden.

Wenn Drain ungleich NULL ist, leitet der Videorenderer bestimmte Nachrichten mithilfe der PostMessage-Funktion an das angegebene Fenster weiter. Welche Nachrichten weitergeleitet werden, hängt möglicherweise vom verwendeten Videorenderer ab. Die Filter Video Renderer und Video Mixing Renderer (VMR) leiten die folgenden Meldungen weiter:

  • 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
Das Fenster für die Nachrichtenentlastung muss kein übergeordnetes Element des Videofensters sein, sodass Vollbildanwendungen diese Methode verwenden können.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile control.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IVideoWindow-Schnittstelle

IVideoWindow::get_MessageDrain