Méthode IOverlayNotify ::OnPositionChange (strmif.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 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 |