XLATEOBJ (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This structure is used to translate color indexes from one palette to another.

typedef struct _XLATEOBJ {
  ULONG iUniq;
  FLONG flXlate;
  USHORT iSrcType;
  USHORT iDstType;
  ULONG cEntries;
  ULONG* pulXlate;


A cache identifier that enables the driver to recognize an XLATEOBJ structure that it has previously cached. If this member is zero, the driver should not cache the XLATEOBJ structure.
Flags specifying hints about the translation. This member can be any combination of flags shown in the following table.
XO_TABLEA table is provided to translate source indices to target indices.
XO_TO_MONOSource indices are translated to a monochrome format with the special property that all indices map to zero, except for one. A driver can use this to accelerate a block transfer.
XO_TRIVIALSource indices are usable as target indices.
XO_DEVICE_ICMNot supported.
XO_FROM_CMYKNot supported.
XO_HOST_ICMNot supported.
Obsolete. Use XLATEOBJ_cGetPalette to query the source format.
Obsolete. Use XLATEOBJ_cGetPalette to query the destination format.
Specifies the number of entries in the array pointed to by the pulXlate member. Indexing into pulXlate with a value greater than cEntries results in a memory access violation.
Pointer to an array of translation entries.


The destination palette always belongs to the destination surface of some drawing operation. The source palette is an application-selected palette or a palette from another surface.

The XLATEOBJ structure is used to translate color indices that refer to the source palette to indices for the destination palette. The resulting index identifies a color that matches the source color as closely as possible.


OS Versions: Windows CE 1.0 and later.
Header: Winddi.h.

See Also

Display Driver Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.