Méthode IOverlay ::Advise (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 Advise méthode configure un lien de conseil pour les événements de superposition spécifiés par le paramètre dwInterests .
Syntaxe
HRESULT Advise(
[in] IOverlayNotify *pOverlayNotify,
[in] DWORD dwInterests
);
Paramètres
[in] pOverlayNotify
Pointeur vers l’interface de notification.
[in] dwInterests
Rappels intéressants, qui peuvent être n’importe quel sous-ensemble des événements suivants.
| Événement | Description |
|---|---|
| ADVISE_NONE | Aucun changement. |
| ADVISE_CLIPPING | Modification de la zone de découpage (synchronisée avec la fenêtre). |
| ADVISE_PALETTE | Modification de la palette. |
| ADVISE_COLORKEY | Modification de la valeur de la clé chromatique. |
| ADVISE_POSITION | Modification de la position de la fenêtre vidéo (non synchronisée avec la fenêtre). |
| ADVISE_DISPLAY_CHANGE | Appelé sur WM_DISPLAYCHANGE. Le message WM_DISPLAYCHANGE est envoyé à toutes les fenêtres lorsque la résolution d’affichage a changé. |
| ADVISE_ALL2 | Toutes les propositions ci-dessus. |
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 configure un lien de conseil pour que l’interface IOverlayNotify reçoive des notifications. Si l’un de ces événements se produit, le point d’entrée approprié dans le paramètre pOverlayNotify transmis est appelé (IOverlayNotify ::OnClipChange, IOverlayNotify ::OnColorKeyChange, IOverlayNotify ::OnPaletteChange ou IOverlayNotify ::OnPositionChange).
Un seul lien de conseil peut être défini sur une interface IOverlay donnée. La tentative de définition d’une autre interface de notification au deuxième et aux appels suivants retourne VFW_E_ADVISE_ALREADY_SET. Vous pouvez annuler un lien d’avis à l’aide de IOverlay ::Unadvise.
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 |