Méthode IOverlay ::SetColorKey (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 SetColorKey méthode modifie la clé de couleur.

Syntaxe

HRESULT SetColorKey(
  [in, out] COLORKEY *pColorKey
);

Paramètres

[in, out] pColorKey

Pointeur vers la valeur de clé de couleur à définir. En cas de réussite, la valeur de clé de couleur réelle sélectionnée est copiée dans ce paramètre.

Valeur retournée

Retourne S_OK en cas de réussite, E_POINTER si pColorKey a la valeur NULL ou E_INVALIDARG si la valeur de pColorKey n’est pas valide pour la palette ou le format de pixel actuel.

Remarques

Si vous modifiez la clé de couleur à l’aide de la SetColorKey méthode , tous les liens conseillés recevront une méthode de rappel IOverlayNotify ::OnColorKeyChange avec la nouvelle couleur.

Lorsque vous utilisez IOverlay ::Advise sur un affichage palettisé, un filtre peut installer une clé de couleur (à l’aide SetColorKeyde ) ou installer une palette (à l’aide de IOverlay ::SetPalette), mais pas les deux. En effet, les touches de couleur de ce mode nécessitent la réalisation d’une palette qui serait en conflit avec SetPalette. Les clés de couleur peuvent être désinstallées en demandant une clé de couleur avec l’indicateur CK_NOCOLORKEY. De même, toute palette installée via SetPalette peut être désinstallée en appelant SetPalette et en transmettant des paramètres NULL (autrement dit, SetPalette(0,NULL)).

La tentative de définition d’une palette lorsqu’une clé de couleur est installée renvoie une erreur VFW_E_PALETTE_SET. La tentative de définition d’une clé de couleur lorsqu’une palette est installée retourne VFW_E_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