XLATEOBJ_cGetPalette
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função recupera as cores de uma paleta especificada ou o formato bitfields da paleta.
Syntax
ULONG XLATEOBJ_cGetPalette(
XLATEOBJ* pxlo,
ULONG iPal,
ULONG cPal,
ULONG* pPal
);
Parameters
- pxlo
[no] Ponteiro para o XLATEOBJ estrutura da qual GDI recupera as informações solicitadas.
iPal
[no] Informações paleta para escrever.A seguinte tabela mostra valores possíveis para esse parâmetro.
Valor Descrição XO_DESTBITFIELDS
GDI recupera o formato bitfields da paleta de destino.
XO_DESTPALETTE
GDI recupera as cores da paleta de destino.
XO_SRCBITFIELDS
GDI recupera o formato bitfields da paleta de origem.
XO_SRCPALETTE
GDI recupera as cores da paleta de origem.
- cPal
[no] Número de entradas na reserva apontado pelo pPal parâmetro. O número de entradas pode ser menor do que o tamanho da paleta.
pPal
[out] Ponteiro para uma reserva no qual GDI grava as informações solicitadas paleta.Se o valor da iPal parâmetro é XO_SRCPALETTE ou XO_DESTPALETTE e o tipo paleta é PAL_INDEXED, cada entrada na reserva é um 24-valor RGB bit.
Se o valor da iPal parâmetro é XO_SRCBITFIELDS ou XO_DESTBITFIELDS e o tipo paleta é PAL_BITFIELDS, PAL_RGB ou PAL_BGR, o pPal parâmetro aponta para três máscaras ULONG que representam as máscaras cor vermelho, verde e azul.
Return Value
Se o valor da pPal parâmetro não for NULL, essa função retorna o número de entradas gravadas. Essa função retorna zero se XLATEOBJ é NULL ou a paleta não é válido.
Essa função também retorna zero se a dados apontado pelo pxlo parâmetro não é consistente com o valor da iPal parâmetro. De exemplo, se os dados apontado pelo pxlo parâmetro é um campo de bits e o iPal parâmetro está definido para XO_SRCPALETTE ou XO_DESTPALETTE, essa função retorna zero. Da mesma forma, se os dados apontado pelo pxlo parâmetro é uma paleta e a iPal parâmetro está definido para XO_SRCBITFIELDS ou XO_DESTBITFIELDS, essa função retorna zero.
Remarks
O driver deve ter informações sobre a paleta para executar métodos misturando cor.
Requirements
| Header | winddi.h |
| Library | Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib |
| Windows Embedded CE | Windows CE 1.0 and later |