XLATEOBJ 結構 (winddi.h)
XLATEOBJ 結構可用來將色彩索引從一個調色盤轉譯到另一個調色盤。
語法
typedef struct _XLATEOBJ {
ULONG iUniq;
FLONG flXlate;
USHORT iSrcType;
USHORT iDstType;
ULONG cEntries;
ULONG *pulXlate;
} XLATEOBJ;
成員
iUniq
快取標識碼，可讓驅動程序辨識先前快取的 XLATEOBJ 結構。 如果這個成員為零，驅動程式不應該快取 XLATEOBJ 結構。
flXlate
旗標，指定翻譯的相關提示。 這個成員可以是下列值的任何組合：
| 值 | 意義 |
|---|---|
| XO_DEVICE_ICM | 裝置上已啟用ICM。 驅動程式應該根據 DrvIcmCreateColorTransform所建立的色彩轉換來轉譯色彩。 驅動程式應該呼叫 XLATEOBJ_hGetColorTransform ，以取得色彩轉換句柄。 這個位與XO_HOST_ICM互斥。 |
| XO_FROM_CMYK | 由於ICM轉譯，來源索引會轉譯為32位 CMYK 色彩格式。 設定此位時，應該忽略 iSrcType、 iDstType、 cEntries 和 pulXlate 。 |
| XO_HOST_ICM | ICM 是由圖形引擎執行，因此此色彩表格中的色彩會更正至目標介面。 此位是由 GDI 設定為驅動程式的信息：驅動程式不需要採取任何動作。 這個位與XO_DEVICE_ICM互斥。 |
| XO_TABLE | 系統會提供數據表，將來源索引轉譯為目標索引。 |
| XO_TO_MONO | 來源索引會轉譯成單色格式，其中包含所有索引對應至零的特殊屬性，但其中一個除外。 驅動程式可以使用此功能來加速區塊傳輸。 |
| XO_TRIVIAL | 來源索引可作為目標索引使用。 |
iSrcType
已過時。 使用 XLATEOBJ_cGetPalette 查詢來源格式。
iDstType
已過時。 使用 XLATEOBJ_cGetPalette 查詢目的地格式。
cEntries
指定 pulXlate 成員所指向之陣列中的項目數。 將值大於 cEntries 的 pulXlate 編製索引會導致記憶體存取違規。
pulXlate
翻譯項目的陣列指標。
備註
目的地調色盤一律屬於某些繪圖作業的目的地介面。 來源調色盤是應用程式選取的調色盤，或來自另一個表面的調色盤。
XLATEOBJ 結構可用來將參考來源調色盤的色彩索引轉譯為目的地調色盤的索引。 產生的索引會識別盡可能符合來源色彩的色彩。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | winddi.h (包括 Winddi.h) |