Méthode IOverlay ::GetColorKey (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 GetColorKey méthode récupère la clé de couleur actuelle utilisée pour la touche chromatique.

Syntaxe

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey
);

Paramètres

[out] pColorKey

Pointeur vers une variable qui reçoit la clé de couleur actuelle pour la touche chromatique.

Valeur retournée

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

Remarques

Si vous modifiez la clé de couleur à l’aide de la méthode IOverlay ::SetColorKey , tous les liens de conseil reçoivent une méthode de rappel IOverlayNotify ::OnColorKeyChange avec la nouvelle couleur.

Si aucune clé de couleur n’est actuellement utilisée, cette méthode retourne VFW_E_NO_COLOR_KEY_SET.

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