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)

另請參閱

DrvIcmCreateColorTransform