SHGetInverseCMAP 函式 (shlwapi.h)
[此函式可透過 Windows XP 和 Windows Server 2003 取得。 後續版本的 Windows 中可能會變更或無法使用。
擷取半色調調色盤的反向色彩表格對應。
語法
LWSTDAPI SHGetInverseCMAP(
[out] BYTE *pbMap,
[in] ULONG cbMap
);
參數
[out] pbMap
類型： BYTE*
接收反向色彩數據表對應之 BYTE 陣列的指標，或接收反向色彩數據表對應之快取複本之 LPBYTE 的指標，視 cbMap 參數的值而定。
[in] cbMap
類型： ULONG
pbMap 指向的緩衝區大小，也會定義其內容。 可辨識兩個值。
(sizeof (BYTE*) )
pbMap 所指向的緩衝區會接收反向色彩地圖數據表快取複本的指標。
(32768)
pbMap 所指向的緩衝區會收到反向色彩地圖數據表的複本。 緩衝區的大小必須剛好是 32,768 個字節。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
反向色彩對應數據表是 32,768 個字節的數據表。 它包含半色調調色盤中色彩的索引。 每個索引都會儲存在緩衝區中對應至以 555 格式表示的特定 RGB 值的位置。 這些配對可讓您在半色調調色盤中尋找色彩，這是原始色彩的近似值。
例如，在半色調調色盤中判斷色彩的方法，其為色彩 #306040 的接近近似值，如下所示：
- 將色彩分解成紅色、綠色和藍色元件。 在此情況下，紅色元件0x30，綠色元件會0x60，而藍色元件則0x40。
- 將色彩重新組合成 555 格式。 此處顯示將 24 位 RGB 色彩縮減為 555 格式的公式。
((red / 8) << 10) + ((blue / 8) << 5) + (green / 8)在此範例中，555 格式的值是 ( (0x30 / 8) << 10) + ( (0x60 / 8) 5) << + (0x40 / 8) = 6536。
- 儲存在反向色彩對應表中位置 6536 的索引值是半色調調色盤中色彩的索引，這是色彩的合理近似值 #306040。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限桌面應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | shlwapi.h |
| 程式庫 | Shlwapi.lib |
| Dll | Shlwapi.dll (5.0 版或更新版本) |