Share via

EngQueryPalette 関数 (winddi.h)

  • [アーティクル]

EngQueryPalette 関数は、指定したパレットの属性を照会します。

構文

ENGAPI ULONG EngQueryPalette(
  HPALETTE hpal,
  ULONG    *piMode,
  ULONG    cColors,
  ULONG    *pulColors
);

パラメーター

hpal

クエリを実行するパレットへのハンドル。

piMode

最初に EngCreatePalette で指定されたパレット モードを受け取る場所へのポインター。

cColors

pulColors がポイントするバッファー内のエントリの数を指定します。 戻り値は 、cColors が負かどうかによって異なります。

pulColors

パレットの色情報を受け取るバッファーへのポインター。 cColors が 0 の場合、pulColors は NULL にすることができます。

戻り値

cColors が 0 の場合、EngQueryPalette は、パレットの色情報を返すために pulColors がポイントするバッファーに必要なパレット エントリの数を返します。 cColors が 0 以外で、pulColors が NULL でない場合、EngQueryPalette は pulColors がポイントするバッファーに書き込まれたエントリの数を返します。

注釈

パレット モードがPAL_BITFIELDS、PAL_RGB、またはPAL_BGRで、 pulColors が指すバッファーが十分な大きさである場合、 pulColors はパレットの赤、緑、青のカラー マスクを表す 3 つの ULONG マスクを指します。

パレット モードがPAL_INDEXEDされ、 pulColors が指すバッファーが十分な大きさである場合、 pulColors にはパレットの色を表す 24 ビット RGB 値がすべて含まれます。

ドライバーは、色が固定または変更可能なパレットを表しているかどうかを判断するために、GCAPS_PALMANAGED フラグの有無をテストする必要があります。

EngQueryPalette は、プライマリ ディスプレイの色形式を知る必要があるミラーリング ドライバーで使用することを目的としています。 ミラーリング ドライバーは通常、 DrvEnablePDEV ルーチンでこの関数を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header winddi.h (Winddi.h を含む)
Library Win32k.lib
[DLL] Win32k.sys

こちらもご覧ください

DrvEnablePDEV

EngCreatePalette