translateBitmapBits 函式 (icm.h)
轉譯具有已定義格式的點陣圖色彩，以便以要求的格式產生另一個點陣圖。
語法
BOOL TranslateBitmapBits(
HTRANSFORM hColorTransform,
PVOID pSrcBits,
BMFORMAT bmInput,
DWORD dwWidth,
DWORD dwHeight,
DWORD dwInputStride,
PVOID pDestBits,
BMFORMAT bmOutput,
DWORD dwOutputStride,
PBMCALLBACKFN pfnCallBack,
LPARAM ulCallbackData
);
參數
hColorTransform
識別要使用的色彩轉換。
pSrcBits
要轉譯之位圖的指標。
bmInput
指定輸入位圖的格式。 必須設定為 BMFORMAT 列舉類型的其中一個值。
注意
此函式不支援 BM_XYZTRIPLETS 或 BM_YxyTRIPLETS 作為輸入。
dwWidth
指定輸入位圖中每個掃描線條的像素數目。
dwHeight
指定輸入點陣圖中的掃描列數。
dwInputStride
指定從一個掃描行開頭到輸入位圖中下一個開頭的位元元組數目;如果設定為零，函式會假設掃描行已填補，以便 對齊 DWORD 對齊。
pDestBits
要放置已轉譯位圖之緩衝區的指標。
bmOutput
指定輸出點陣圖的格式。 必須設定為 BMFORMAT 列舉類型的其中一個值。
dwOutputStride
指定從一個掃描行的開頭到輸出點陣圖中下一個開頭的位元元組數目;如果設定為零，函式會假設掃描行應該填補為 DWORD 對齊。
pfnCallBack
TranslateBitmapBits 定期呼叫的回呼函式指標，以報告進度，並允許呼叫程式取消翻譯。 (請參閱 ICMProgressProcCallback )
ulCallbackData
例如，傳回回回呼函式的數據，用來識別報告進度的轉譯。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。
備註
如果輸入和輸出格式與色彩轉換不相容，則此函式會失敗。
當使用任一浮點BMFORMAT、BM_32b_scARGB或BM_32b_scRGB時，要轉譯的色彩數據不應包含 NaN 或無限大。 NaN 和無限大不會被視為代表合法的色彩元件值，而轉譯包含 NaN 或無限大之像素的結果在色彩方面則無意義。 正在處理之色彩數據中的 NaN 或無限大值會以無訊息方式處理，而且不會傳回錯誤。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |