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 を含む)

こちらもご覧ください

DrvEnablePDEV

EngCreatePalette

EngDeletePalette