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

Voir aussi

Codes d’erreur et de réussite

IOverlay, interface