Compartilhar via


PFND3DDDI_UPDATEPALETTE função de retorno de chamada (d3dumddi.h)

A função UpdatePalette atualiza uma paleta de texturas.

Sintaxe

PFND3DDDI_UPDATEPALETTE Pfnd3dddiUpdatepalette;

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

Parâmetros

[in] hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDIARG_UPDATEPALETTE que descreve parâmetros para a operação de atualização de paleta.

unnamedParam3

pPaletteData [in]

Uma matriz de estruturas PALETTEENTRY a serem atualizadas. Para obter mais informações sobre PALETTEENTRY, consulte a documentação do SDK do Microsoft Windows.

Retornar valor

UpdatePalette retornará S_OK ou um resultado de erro apropriado se a paleta de texturas não for atualizada com êxito.

Comentários

Os dados de paleta na matriz especificada por pPaletteData consistem em um valor UINT para cada entrada de paleta (estrutura PALETTEENTRY). A entrada de paleta está no formato ARGB, com 8 bits para cada um dos quatro canais.

O driver de exibição do modo de usuário usa os seguintes membros da estrutura D3DDDIARG_UPDATEPALETTE apontados pelo pData para atualizar a paleta de texturas:

  • O membro PaletteHandle especifica o identificador para a paleta associada à superfície.
  • O membro StartIndex especifica o índice da entrada na matriz em pPaletteData em que a atualização deve ser iniciada.
  • O membro NumEntries especifica o número de entradas na matriz em pPaletteData a serem atualizadas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_UPDATEPALETTE

D3DDDI_DEVICEFUNCS