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

Artikel
07/28/2023

[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

Freigeben über