Compartilhar via


Método IDirectDrawPalette::GetCaps (ddraw.h)

Recupera os recursos do objeto de paleta.

Sintaxe

HRESULT GetCaps(
  [out] LPDWORD unnamedParam1
);

Parâmetros

[out] unnamedParam1

Um ponteiro para uma variável que recebe um valor do membro dwPalCaps da estrutura DDCAPS que define os recursos de paleta. Esse valor consiste em um ou mais dos sinalizadores a seguir.

DDPCAPS_1BIT

O índice é de 1 bit. Há duas entradas na tabela de cores.

DDPCAPS_2BIT

O índice é de 2 bits. Há quatro entradas na tabela de cores.

DDPCAPS_4BIT

O índice é de 4 bits. Há 16 entradas na tabela de cores.

DDPCAPS_8BIT

O índice é de 8 bits. Há 256 entradas na tabela de cores.

DDPCAPS_8BITENTRIES

O índice refere-se a um índice de cores de 8 bits. Esse sinalizador só é válido quando usado com o sinalizador DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT e quando a superfície de destino é de 8 bpp. Cada entrada de cor tem 1 byte de comprimento e é um índice para a paleta de 8 bpp de uma superfície de destino.

DDPCAPS_ALPHA

O membro peFlags da estrutura PALETTEENTRY associada deve ser interpretado como um único valor alfa de 8 bits (além dos membros peRed, peGreen e peBlue ). Uma paleta criada com esse sinalizador só pode ser anexada a uma textura: uma superfície criada com o sinalizador de funcionalidade DDSCAPS_TEXTURE.

DDPCAPS_ALLOW256

Essa paleta pode ter todas as 256 entradas definidas.

DDPCAPS_PRIMARYSURFACE

Essa paleta está anexada à superfície primária. Alterar a tabela de cores dessa paleta afeta imediatamente a exibição, a menos que DDPSETPAL_VSYNC seja especificado e tenha suporte.

DDPCAPS_PRIMARYSURFACELEFT

Essa paleta é aquela anexada à superfície primária do olho esquerdo. Alterar a tabela de cores dessa paleta afeta imediatamente a exibição do olho esquerdo, a menos que DDPSETPAL_VSYNC seja especificado e tenha suporte.

DDPCAPS_VSYNC

Essa paleta pode ter modificações na sincronização com a taxa de atualização do monitor.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDrawPalette