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

  • Article

[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