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
关联的 PALETTEENTRY 结构的 peFlags 成员除了 peRed、peGreen 和 peBlue 成员) 外，还必须解释为单个 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 |
| Library | Ddraw.lib |
| DLL | Ddraw.dll |