drvIcmCheckBitmapBits 函式 (winddi.h)
DrvIcmCheckBitmapBits 函式會檢查指定位圖中的圖元是否位於指定轉換的裝置遊戲內。
語法
BOOL DrvIcmCheckBitmapBits(
DHPDEV dhpdev,
HANDLE hColorTransform,
SURFOBJ *pso,
PBYTE paResults
);
參數
dhpdev
實體裝置 PDEV 的句柄。
hColorTransform
要檢查點陣圖的色彩轉換句柄。 此轉換是由驅動程式透過先前呼叫 其DrvIcmCreateColorTransform 例程所建立。
pso
SURFOBJ 的指標，其中包含要檢查的點陣圖表面。
paResults
驅動程式傳回測試結果的位元組數位指標。 GDI 會配置此緩衝區，以至少包含位圖中有圖元的位元組數。 驅動程式在寫入陣列之前，不需要執行任何配置或系結檢查。
傳回值
DrvIcmCheckBitmapBits 會在成功時傳回 TRUE 。 否則，它會報告錯誤並傳回 FALSE。
備註
paResults 點對應至位圖中圖元之陣列中的每個位元組。 對於每個像素，驅動程式會判斷其色彩值是否位於裝置遊戲中，然後在對應的陣列位元組中寫入介於零到255之間的值。 這些值具有下列意義：
| 值 | 意義 |
|---|---|
| 零個 | 色彩位於裝置遊戲中。 |
| 零 | 色彩不在遊戲之外。 n+1 的值表示色彩至少遠超過 gamut 的值 n。 |
DrvIcmCheckBitmapBits 可以選擇性地在支援ICM的驅動程序中實作。 驅動程式會在 DEVINFO 結構的 flGraphicsCaps 成員中設定 GCAPS_ICM 旗標，以指出 ICM 的支援。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winddi.h (包含Winddi.h) |