IDirectDrawPalette：：GetCaps 方法 (ddraw.h)
擷取調色盤物件的功能。
語法
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
參數
[out] unnamedParam1
從定義調色盤功能的 DDCAPS 結構 dwPalCaps 成員接收值的變數指標。 這個值是由下列一或多個旗標所組成。
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
除了peRed、peGreen和peBlue成員之外，相關聯的PALETTEENTRY結構的peFlags成員必須解譯為單一8位Alpha值) (。 使用這個旗標建立的調色盤只能附加至紋理：使用 DDSCAPS_TEXTURE 功能旗標建立的介面。
DDPCAPS_ALLOW256
此調色盤可以定義所有 256 個專案。
DDPCAPS_PRIMARYSURFACE
這個調色盤會附加至主要介面。 除非指定並支援DDPSETPAL_VSYNC，否則變更此調色盤的色彩表格會立即影響顯示器。
DDPCAPS_PRIMARYSURFACELEFT
此調色盤是附加至左眼主要表面的調色盤。 除非指定並支援DDPSETPAL_VSYNC，否則變更此調色盤的色彩表格會立即影響左眼顯示器。
DDPCAPS_VSYNC
此調色盤可以修改它與監視器的重新整理速率同步處理。
傳回值
如果方法成功，傳回值會DD_OK。
如果失敗，方法可以傳回下列其中一個錯誤值：
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | ddraw.h |
| 程式庫 | Ddraw.lib |
| Dll | Ddraw.dll |