Share via

HT_Get8BPPFormatPalette関数 (winddi.h)

  • [アーティクル]

HT_Get8BPPFormatPalette関数は、ピクセルデバイスの種類ごとに標準の 8 ビットで使用するハーフトーン パレットを返します。

構文

LONG HT_Get8BPPFormatPalette(
  [out] LPPALETTEENTRY pPaletteEntry,
  [in]  USHORT         RedGamma,
  [in]  USHORT         GreenGamma,
  [in]  USHORT         BlueGamma
);

パラメーター

[out] pPaletteEntry

PALETTEENTRY 構造体の配列へのポインター (Microsoft Windows SDKドキュメントで説明)。 このポインターが NULL でない場合、GDI は、GDI がピクセルごとの 8 ビット全体のハーフトーン パレットを配置できる有効なメモリ空間を指していると見なします。

[in] RedGamma

赤、緑、青のガンマ値を指定します。 この USHORT 値は、4 桁の最下位桁数が (暗黙的な) 小数点の右側にある実数として解釈されます。 たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表します。 許容される最小ガンマ値は 0.0000 で、最大許容値は 6.5535 です。

[in] GreenGamma

赤、緑、青のガンマ値を指定します。 この USHORT 値は、4 桁の最下位桁数が (暗黙的な) 小数点の右側にある実数として解釈されます。 たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表します。 許容される最小ガンマ値は 0.0000 で、最大許容値は 6.5535 です。

[in] BlueGamma

赤、緑、青のガンマ値を指定します。 この USHORT 値は、4 桁の最下位桁数が (暗黙的な) 小数点の右側にある実数として解釈されます。 たとえば、ガンマ値 10000 は実数 1.0000 を表し、12345 は 1.2345 を表します。 許容される最小ガンマ値は 0.0000 で、最大許容値は 6.5535 です。

戻り値

pPaletteEntry が NULL でない場合、戻り値は、pPaletteEntry が指すメモリ位置から GDI が入力した PALETTEENTRY 構造体の数です。 pPaletteEntry が NULL の場合、戻り値は、ピクセルごとの 8 ビット ハーフトーン パレットを格納するために必要な PALETTEENTRY 構造体の合計数です。

注釈

HT_Get8BPPFormatPalette は、ドライバーがシステムの標準 8 ビット/ピクセル ハーフトーン パレットを取得するために使用できる、ハーフトーン関連の GDI サービスです。

要件

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