D3DHAL_DP2SETPALETTE 结构 (d3dhal.h)

当驱动程序响应 D3dDrawPrimitives2 中的D3DDP2OP_SETPALETTE时，D3DHAL_DP2SETPALETTE结构用于将调色板与纹理相关联。 此操作码用于映射调色板句柄和图面句柄之间的关联，并指定调色板的特征。

语法

typedef struct _D3DHAL_DP2SETPALETTE {
  DWORD dwPaletteHandle;
  DWORD dwPaletteFlags;
  DWORD dwSurfaceHandle;
} D3DHAL_DP2SETPALETTE;

成员

dwPaletteHandle

指定要设置的调色板的句柄。 如果值为零，则 dwSurfaceHandle 指定的图面应与之前可能关联的任何调色板取消耦合。

dwPaletteFlags

指定一组指定调色板属性的标志。 |标志 |含义| |--- |--- | |DDRAWIPAL_2 |调色板有 2 个条目。 当前未使用。||DDRAWIPAL_4 |调色板有 4 个条目。 当前未使用。||DDRAWIPAL_16 |调色板包含 16 个条目。 当前未使用。||DDRAWIPAL_256 |调色板包含 256 个条目。 当前未使用。||DDRAWIPAL_ALLOW256 |调色板可以完全更新。 当前未使用。||DDRAWIPAL_ALPHA |调色板的 alpha 数据通道有效，应使用。||DDRAWIPAL_DIRTY |调色板已更改，因此 GDI 调色板不同步。当前未使用。||DDRAWIPAL_EXCLUSIVE |调色板正在独占模式下使用。 当前未使用。||DDRAWIPAL_GDI |调色板通过 GDI 分配。 当前未使用。||DDRAWIPAL_INHEL |调色板在 HEL (硬件仿真层) 完成。 当前未使用。||DDRAWIPAL_STORED_8|使用每个条目 8 bpp 存储调色板。 当前未使用。||DDRAWIPAL_STORED_16|使用每个条目 16 bpp 存储调色板。 当前未使用。||DDRAWIPAL_STORED_24 |使用每个条目 24 bpp 存储调色板。 当前未使用。||DDRAWIPAL_STORED_8INDEX |调色板作为 8 位索引存储在目标调色板中。 当前未使用。|

dwSurfaceHandle

指定 direct3D 图面的句柄， (纹理) ，该调色板 (由 dwPaletteHandle) 所标识。

注解

要遵循的D3DHAL_DP2SETPALETTE结构的数目由命令流中位于其前面的D3DHAL_DP2COMMAND结构的 wStateCount 成员指定。

要求

另请参阅

D3DDP2OP_SETPALETTE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2