IDDrawExclModeVideoCallback ::OnUpdateOverlay, méthode (strmif.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 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 OnUpdateOverlay méthode informe l’application quand la surface de superposition de la vidéo est sur le point de devenir visible, invisible, de changer de taille ou de changer de position, afin que l’application puisse repeindre sa fenêtre de manière appropriée.

Syntaxe

HRESULT OnUpdateOverlay(
  [in] BOOL       bBefore,
  [in] DWORD      dwFlags,
  [in] BOOL       bOldVisible,
  [in] const RECT *prcOldSrc,
  [in] const RECT *prcOldDest,
  [in] BOOL       bNewVisible,
  [in] const RECT *prcNewSrc,
  [in] const RECT *prcNewDest
);

Paramètres

[in] bBefore

Valeur booléenne spécifiant si l’appel est effectué avant ou après la modification liée à la superposition. TRUE spécifie avant, FALSE spécifie après.

[in] dwFlags

Valeur de l’énumération AM_OVERLAY_NOTIFY_FLAGS qui spécifie ce qui est sur le point de changer ou ce qui a changé.

[in] bOldVisible

Valeur booléenne spécifiant si l’ancienne fenêtre est visible. TRUE signifie que l’ancienne fenêtre est visible.

[in] prcOldSrc

Pointeur vers le rectangle représentant l’ancienne position source de la surface DirectDraw.

[in] prcOldDest

Pointeur vers le rectangle représentant l’ancienne position de destination du rectangle dans la surface de superposition.

[in] bNewVisible

Boolean spécifiant si la nouvelle fenêtre est visible. TRUE signifie que la nouvelle fenêtre est visible.

[in] prcNewSrc

Pointeur vers le rectangle représentant la nouvelle position source de la surface DirectDraw.

[in] prcNewDest

Pointeur vers le rectangle représentant la nouvelle position de destination du rectangle dans la surface de superposition.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Paramètre non valide.

Remarques

L’application doit appeler cette méthode une fois avant la modification liée à la superposition et une fois que les modifications sont effectuées. Dans l’appel avant la modification, la modification de superposition ne se produit pas tant que l’application n’a pas terminé l’exécution de cette méthode.

Configuration requise

Condition requise	Valeur
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	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IDDrawExclModeVideoCallback Interface

Partager via