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 |