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 がポイントする配列内の各バイトは、ビットマップ内のピクセルに対応します。各ピクセルについて、ドライバーは色の値がデバイスの色域にあるかどうかを判断し、対応する配列バイトに 0 から 255 までの値を書き込みます。値の意味は次のとおりです。

値	意味
ゼロ	色はデバイスの色域にあります。
0 以外	色は色域外です。 n + 1 の値は、色が n の値と同じ色域から少なくとも遠く離れていることを示します。

DrvIcmCheckBitmapBits は、必要に応じて ICM をサポートするドライバーに実装できます。ドライバーは、DEVINFO 構造体の flGraphicsCaps メンバーでGCAPS_ICM フラグを設定することによって ICM のサポートを示します。

要件	値
対象プラットフォーム	デスクトップ
Header	winddi.h (Winddi.h を含む)