IDirectDraw7：：CreatePalette 方法 (ddraw.h)
建立這個 DirectDraw 物件的 DirectDrawPalette 物件。
語法
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
參數
[in] unnamedParam1
此值包含下列一或多個旗標：
DDPCAPS_1BIT
索引為1位。 色彩表格中有兩個專案。
DDPCAPS_2BIT
索引為2位。 色彩表格中有四個專案。
DDPCAPS_4BIT
索引為 4 位。 色彩表格中有16個專案。
DDPCAPS_8BIT
索引為8位。 色彩表格中有256個專案。
DDPCAPS_8BITENTRIES
索引是指8位色彩索引。 只有在與DDPCAPS_1BIT、DDPCAPS_2BIT或DDPCAPS_4BIT旗標搭配使用，且目標介面為 8 bpp 時，此旗標才有效。 每個色彩專案都是 1 位元組長，而且是目的地表面 8-bpp 調色盤的索引。
DDPCAPS_ALPHA
關聯 PALETTEENTRY 結構的 peFlags 成員除了 peRed、peGreen 和 peBlue 成員之外，還會解譯為單一 8 位 Alpha 值) (。 使用此旗標建立的調色盤只能附加至紋理：使用 DDSCAPS_TEXTURE 功能旗標建立的介面。
DDPCAPS_ALLOW256
此調色盤可以定義所有 256 個專案。
DDPCAPS_INITIALIZE
已過時。 DirectDraw 一律會使用在 lpDDColorArray 傳遞之色彩陣列中的色彩初始化此調色盤。
DDPCAPS_PRIMARYSURFACE
這個調色盤會附加至主要介面。 除非指定並支援DDPSETPAL_VSYNC，否則變更此調色盤的色彩表格會立即影響顯示器。
DDPCAPS_PRIMARYSURFACELEFT
此調色盤是附加至左眼主要表面的調色盤。 除非指定並支援DDPSETPAL_VSYNC，否則變更此調色盤的色彩表格會立即影響左眼顯示器。
DDPCAPS_VSYNC
此調色盤可以修改它與監視器的重新整理速率同步處理。
[in] unnamedParam2
2、4、16 或 256 PALETTEENTRY 結構的數位位址，以初始化 DirectDrawPalette 物件。
[out] unnamedParam3
如果呼叫成功，要設定為有效 IDirectDrawPalette 介面指標的變數位址。
[in] unnamedParam4
允許未來與 COM 匯總功能相容。 目前，如果此參數不是 NULL，這個方法會傳回錯誤。
傳回值
如果方法成功，傳回值會DD_OK。
如果失敗，方法可以傳回下列其中一個錯誤值：
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | ddraw.h |
| 程式庫 | Ddraw.lib |
| Dll | Ddraw.dll |