IDirect3DDevice9：：SetPaletteEntries 方法 (d3d9.h)

發行項
02/26/2024

設定調色盤專案。

語法

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，調色盤中的每個專案都必須將Alpha設定為1.0，否則此方法將會失敗並D3DERR_INVALIDCALL。如果已設定D3DPTEXTURECAPS_ALPHAPALETTE，則允許任何一組 Alpha 值。請注意，如果所有調色盤項目都設定為 0，偵錯運行時間將會列印警告訊息。

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