DrvSetPalette 関数 (winddi.h)

DrvSetPalette 関数は、ドライバーが指定したデバイスのパレットを実現することを要求します。

構文

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

dhpdev

物理デバイスの PDEV 構造体を処理します。これは、パレットを実現するデバイスを識別します。このパラメーターは、 DrvEnablePDEV によって GDI に返されるデバイスハンドルです。

ppalo

色 (RGB 値) を照会する必要がある PALOBJ 構造体へのポインター。

fl

ヒントとオプションを提供するフラグのセット。このパラメーターには、次の値を指定できます。

値	意味
SP_DEFAULT	パレットは、デバイスの完全な既定のパレットです。 PALOBJ は無視できますが、正しい内容が含まれています。

iStart

上書きする最初のパレットインデックスを指定します。

cColors

ハードウェアパレットで変更する色の数を指定します。ハードウェアで使用できる数を超える余分な色は無視できます。 cColors がハードウェアパレットのサイズよりも小さい場合は、cColors エントリのみを設定し、残りの色はそのままにします。

関数が成功した場合、戻り値は TRUE です。それ以外の場合は FALSE になり、エラーコードがログに記録されます。

ドライバーは、ハードウェアパレットを、指定されたパレット内のエントリとできるだけ密接に一致するように設定します。

インデックス付きパレットのみが実現可能です。 GDIINFO 構造体の flRasterCaps メンバーのRC_PALETTE ビットは、デバイスに実現可能なパレットがあるかどうかを指定します。

DrvSetPalette は、実現可能なパレットをサポートするディスプレイドライバーに必要です。

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