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

指定紅色、綠色和藍色 gamma 值。 這個 USHORT 值會解譯為實數，其四個最小有效位數位於 (隱含) 小數點右邊。 例如，gamma 值為 10000 代表實數 1.0000，而 12345 則代表 1.2345。 允許的最小 gamma 值為 0.0000，而允許的最大值為 6.5535。

[in] GreenGamma

指定紅色、綠色和藍色 gamma 值。 這個 USHORT 值會解譯為實數，其四個最小有效位數位於 (隱含) 小數點右邊。 例如，gamma 值為 10000 代表實數 1.0000，而 12345 則代表 1.2345。 允許的最小 gamma 值為 0.0000，而允許的最大值為 6.5535。

[in] BlueGamma

指定紅色、綠色和藍色 gamma 值。 這個 USHORT 值會解譯為實數，其四個最小有效位數位於 (隱含) 小數點右邊。 例如，gamma 值為 10000 代表實數 1.0000，而 12345 則代表 1.2345。 允許的最小 gamma 值為 0.0000，而允許的最大值為 6.5535。

傳回值

如果 pPaletteEntry 不是 NULL，則傳回值是 GDI 從 pPaletteEntry 所指向的記憶體位置開始填入的 PALETTEENTRY 結構數目。 如果 pPaletteEntry 為 NULL，則傳回值是儲存每圖元半色調調色盤 8 位所需的 PALETTEENTRY 結構總數。

備註

HT_Get8BPPFormatPalette 是一個半色調相關的 GDI 服務，驅動程式可用來取得每個圖元半色調調色盤的標準 8 位。

規格需求