Méthode IOverlayNotify ::OnPositionChange (strmif.h)

Article
03/02/2024

[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 OnPositionChange méthode indique que la position a changé.

Syntaxe

HRESULT OnPositionChange(
  [in] const RECT *pSourceRect,
  [in] const RECT *pDestinationRect
);

Paramètres

[in] pSourceRect

Pointeur vers le rectangle vidéo source.

[in] pDestinationRect

Pointeur vers le rectangle vidéo de destination. Notez que ce n’est pas coupé dans la zone d’affichage visible.

Valeur retournée

Retourne S_OK en cas de réussite. Si la méthode échoue, elle retourne un code d’erreur HRESULT .

Remarques

Cette méthode est un rappel destiné à être utilisé par les cartes de superposition matérielles qui ne souhaitent pas les frais liés aux mises à jour de découpage synchrone et qui veulent simplement savoir quand la position de la vidéo source ou de destination change.

Contrairement à la méthode IOverlayNotify ::OnClipChange , cette méthode n’est pas appelée en synchronisation avec la fenêtre qui change, mais plutôt à un moment donné après la modification de la fenêtre (essentiellement dans le temps avec WM_SIZE messages reçus). Cela convient donc aux cartes de superposition qui n’insèrent pas leurs données dans la mémoire tampon de trame.

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

IOverlayNotify, interface

Partager via