Structure XLATEOBJ (winddi.h)
La structure XLATEOBJ est utilisée pour traduire des index de couleur d’une palette à l’autre.
Syntaxe
typedef struct _XLATEOBJ {
ULONG iUniq;
FLONG flXlate;
USHORT iSrcType;
USHORT iDstType;
ULONG cEntries;
ULONG *pulXlate;
} XLATEOBJ;
Membres
iUniq
Identificateur de cache qui permet au pilote de reconnaître une structure XLATEOBJ qu’il a précédemment mise en cache. Si ce membre est égal à zéro, le pilote ne doit pas mettre en cache la structure XLATEOBJ.
flXlate
Indicateurs spécifiant des indicateurs sur la traduction. Ce membre peut être n’importe quelle combinaison des valeurs suivantes :
| Valeur | Signification |
|---|---|
| XO_DEVICE_ICM | ICM est activé sur l’appareil. Le pilote doit traduire la couleur en fonction de la transformation de couleur créée par DrvIcmCreateColorTransform. Le pilote doit appeler XLATEOBJ_hGetColorTransform pour obtenir le handle de transformation de couleur. Ce bit s’exclut mutuellement de XO_HOST_ICM. |
| XO_FROM_CMYK | À la suite de la traduction ICM, les index sources sont traduits au format de couleur CMJN 32 bits. Lorsque ce bit est défini, iSrcType, iDstType, cEntries et pulXlate doivent être ignorés. |
| XO_HOST_ICM | ICM étant effectué par le moteur graphique, les couleurs de cette table de couleurs sont corrigées sur la surface cible. Ce bit est défini par le GDI en tant qu’informations pour le pilote : aucune action n’est requise par le pilote. Ce bit s’exclut mutuellement de XO_DEVICE_ICM. |
| XO_TABLE | Une table est fournie pour traduire les index sources en index cibles. |
| XO_TO_MONO | Les index sources sont traduits dans un format monochrome avec la propriété spéciale que tous les index sont mappés à zéro, à l’exception d’un seul. Un pilote peut l’utiliser pour accélérer un transfert de bloc. |
| XO_TRIVIAL | Les index sources sont utilisables en tant qu’index cibles. |
iSrcType
Est obsolète. Utilisez XLATEOBJ_cGetPalette pour interroger le format source.
iDstType
Est obsolète. Utilisez XLATEOBJ_cGetPalette pour interroger le format de destination.
cEntries
Spécifie le nombre d’entrées dans le tableau pointé vers le membre pulXlate . L’indexation dans pulXlate avec une valeur supérieure à cEntries entraîne une violation de l’accès à la mémoire.
pulXlate
Pointeur vers un tableau d’entrées de traduction.
Remarques
La palette de destination appartient toujours à la surface de destination d’une opération de dessin. La palette source est une palette sélectionnée par l’application ou une palette d’une autre surface.
La structure XLATEOBJ est utilisée pour traduire les index de couleur qui font référence à la palette source en index pour la palette de destination. L’index résultant identifie une couleur qui correspond à la couleur source aussi étroitement que possible.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | winddi.h (inclure Winddi.h) |