PFND3DDDI_UPDATEPALETTE回调函数 (d3dumddi.h)

  • 项目

UpdatePalette 函数更新纹理调色板。

语法

PFND3DDDI_UPDATEPALETTE Pfnd3dddiUpdatepalette;

HRESULT Pfnd3dddiUpdatepalette(
  [in] HANDLE hDevice,
       const D3DDDIARG_UPDATEPALETTE *unnamedParam2,
       const PALETTEENTRY *unnamedParam3
)
{...}

参数

[in] hDevice

显示设备的句柄 (图形上下文) 。

unnamedParam2

pData [in]

指向描述调色板更新操作参数 的 D3DDDIARG_UPDATEPALETTE 结构的指针。

unnamedParam3

pPaletteData [in]

要更新的 PALETTEENTRY 结构的数组。 有关 PALETTEENTRY 的详细信息，请参阅Microsoft Windows SDK文档。

返回值

如果纹理调色板未成功更新，UpdatePalette 将返回S_OK或适当的错误结果。

注解

pPaletteData 指定的数组中的调色板数据由每个调色板项的一个 UINT 值组成， (PALETTEENTRY 结构) 。 调色板条目采用 ARGB 格式，四个通道各有 8 位。

用户模式显示驱动程序使用 pData 指向的D3DDDIARG_UPDATEPALETTE结构的以下成员来更新纹理调色板：

  • PaletteHandle 成员指定与图面关联的调色板的句柄。
  • StartIndex 成员指定数组中应开始更新的 pPaletteData 中条目的索引。
  • NumEntries 成员指定要更新的 pPaletteData 处数组中的条目数。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_UPDATEPALETTE

D3DDDI_DEVICEFUNCS