Partager via


Méthode CImagePalette.MakeIdentityPalette

[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 MakeIdentityPalette méthode tente de créer une « palette d’identités », définie comme une palette qui mappe directement à la palette sélectionnée dans l’appareil d’affichage.

Syntaxe

HRESULT MakeIdentityPalette(
   PALETTEENTRY *pEntry,
   INT          iColours,
   LPSTR        szDevice
);

Paramètres

pEntry

Pointeur vers un tableau d’entrées de palette.

iColours

Nombre d’entrées de palette dans pEntry.

szDevice

Pointeur vers une chaîne qui contient le nom du périphérique d’affichage, tel que retourné par la fonction GDI EnumDisplayDevices . Pour utiliser le périphérique d’affichage main, définissez ce paramètre sur NULL.

Valeur renvoyée

Retourne S_OK en cas de réussite ou S_FALSE en cas d’échec.

Notes

Cette méthode compare les entrées réservées dans la palette système aux entrées correspondantes dans le tableau pEntry . Si elles correspondent exactement, la méthode définit l’indicateur PC_NOCOLLAPSE dans les entrées de palette restantes (non réservées) dans pEntry. Cet indicateur empêche GDI d’essayer de mapper des entrées de palette logique aux entrées de palette système.

La méthode CImagePalette::MakePalette appelle cette méthode.

Configuration requise

Condition requise Valeur
En-tête
Winutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CImagePalette, classe