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)