IMediaEventEx::SetNotifyWindow, méthode (control.h)

[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 SetNotifyWindow méthode inscrit une fenêtre pour traiter les notifications d’événements.

Syntaxe

HRESULT SetNotifyWindow(
  [in] OAHWND   hwnd,
  [in] long     lMsg,
  [in] LONG_PTR lInstanceData
);

Paramètres

[in] hwnd

Gérez vers la fenêtre ou NULL pour arrêter de recevoir des messages d’événement.

[in] lMsg

Message de fenêtre à passer en tant que notification.

[in] lInstanceData

Valeur à passer en tant que paramètre lParam pour le message lMsg .

Valeur renvoyée

Retourne S_OK en cas de réussite ou E_INVALIDARG si le paramètre hwnd n’est pas un handle valide pour une fenêtre.

Notes

Cette méthode désigne une fenêtre qui traitera les notifications d’événements. Chaque fois que le Gestionnaire de graphes de filtre place un événement dans la file d’attente d’événements, il publie également un message dans la fenêtre désignée. Le paramètre hwnd spécifie la fenêtre et le paramètre lMsg spécifie le message. L’application doit définir un message de fenêtre privée à cet effet. Le paramètre lParam du message est défini sur la valeur de lInstanceData et le paramètre wParam est défini sur zéro.

Lorsque la fenêtre reçoit le message, elle doit appeler la méthode IMediaEvent::GetEvent pour récupérer l’événement. Les événements étant asynchrones, la file d’attente peut contenir plusieurs événements (ou aucun). Appelez GetEvent à plusieurs reprises, jusqu’à ce qu’il retourne un code d’erreur.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IMediaEventEx, interface