Méthode IVideoWindow::p ut_MessageDrain (control.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La put_MessageDrain méthode spécifie une fenêtre pour recevoir des messages de souris et de clavier à partir de la fenêtre vidéo.

Syntaxe

HRESULT put_MessageDrain(
  [in] OAHWND Drain
);

Paramètres

[in] Drain

Handle de la fenêtre, sous la forme d’une valeur OAHWND .

Valeur renvoyée

Les valeurs de retour possibles sont les suivantes :

Code de retour	Description
S_OK	Opération réussie.
VFW_E_NOT_CONNECTED	Le filtre du convertisseur vidéo n’est pas connecté.

Notes

Cette méthode permet à une application de répondre aux événements de souris et de clavier générés dans la fenêtre vidéo.

Si Drain n’a pas la valeur NULL, le convertisseur vidéo transfère certains messages vers la fenêtre spécifiée, à l’aide de la fonction PostMessage . Les messages transférés peuvent dépendre du convertisseur vidéo utilisé. Le convertisseur vidéo et le générateur de mixage vidéo (VMR) filtrent les messages suivants :

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 fenêtre de drain de messages n’a pas besoin d’être un parent de la fenêtre vidéo, de sorte que les applications plein écran peuvent utiliser cette méthode.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	control.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IVideoWindow, interface

IVideoWindow::get_MessageDrain

Partager via