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 |