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 |