IDirect3DDevice9：：SetPaletteEntries 方法 (d3d9helper.h)

發行項
08/23/2023

設定調色盤專案。

語法

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

參數

[in] PaletteNumber

類型： UINT

識別要執行作業的特定調色盤的序數值。

[in] pEntries

類型：const PALETTEENTRY*

PALETTEENTRY結構的指標，代表要設定的調色盤專案。 pEntries 所指向的 PALETTEENTRY 結構數目假設為 256。請參閱＜備註＞。

傳回值

類型： HRESULT

如果方法成功，傳回值會D3D_OK。如果方法失敗，則傳回值可以D3DERR_INVALIDCALL。

備註

對於 Direct3D 9 應用程式，傳送至此方法的任何調色盤都必須符合 D3DCAPS9 結構的D3DPTEXTURECAPS_ALPHAPALETTE功能位。如果未設定D3DPTEXTURECAPS_ALPHAPALETTE，調色盤中的每個專案都必須設定為 1.0，否則此方法將會失敗並D3DERR_INVALIDCALL。如果已設定D3DPTEXTURECAPS_ALPHAPALETTE，則允許任何一組 Alpha 值。請注意，如果所有調色盤專案都設定為 0，偵錯執行時間將會列印警告訊息。

單一邏輯調色盤與裝置相關聯，且會由所有紋理階段共用。