CBaseControlWindow.put_Owner méthode

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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_Owner méthode définit la fenêtre parente de la fenêtre vidéo ; la fenêtre parente transfère ensuite certains messages à la fenêtre vidéo.

Syntaxe

HRESULT put_Owner(
   OAHWND Owner
);

Paramètres

Propriétaire

Handle vers la fenêtre parente.

Valeur renvoyée

Retourne NOERROR.

Notes

En interne, cette méthode appelle la fonction Microsoft Win32 SetParent pour définir le nouveau propriétaire et définit le style de la fenêtre parente sur WS_CHILD. La fenêtre parente transfère ensuite certains ensembles de messages (en particulier les messages de souris et de clavier) à la fenêtre vidéo.

Après avoir défini le propriétaire de la fenêtre vidéo, vous devez définir le propriétaire sur NULL et le style de fenêtre du propriétaire sur WS_OVERLAPPED et WS_CLIPCHILDREN avant de publier le graphique de filtre. Lorsque vous définissez le propriétaire sur NULL, cette méthode désactive le bit WS_CHILD de la fenêtre parente. Si vous ne définissez pas le propriétaire sur NULL, la fenêtre parente continue de transmettre des messages à la fenêtre vidéo et des erreurs se produisent probablement lorsque l’application se ferme.

Configuration requise

Condition requise	Valeur
En-tête	Ctlutil.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

CBaseControlWindow, classe