Compartilhar via

Função DrvIcmCheckBitmapBits (winddi.h)

  • Artigo

A função DrvIcmCheckBitmapBits verifica se os pixels no bitmap especificado estão dentro da gama de dispositivos da transformação especificada.

Sintaxe

BOOL DrvIcmCheckBitmapBits(
  DHPDEV  dhpdev,
  HANDLE  hColorTransform,
  SURFOBJ *pso,
  PBYTE   paResults
);

Parâmetros

dhpdev

Manipule para o PDEV do dispositivo físico.

hColorTransform

Manipule para a transformação de cores na qual o bitmap deve ser verificado. Essa transformação foi criada pelo driver por meio de uma chamada anterior à rotina DrvIcmCreateColorTransform .

pso

Ponteiro para o SURFOBJ que contém a superfície de bitmap a ser verificada.

paResults

Ponteiro para uma matriz de bytes em que o driver retorna os resultados do teste. A GDI aloca esse buffer para conter pelo menos quantos bytes houver pixels no bitmap. O driver não precisa executar nenhuma alocação ou verificação associada antes de gravar na matriz.

Retornar valor

DrvIcmCheckBitmapBits retorna TRUE após o sucesso. Caso contrário, ele relatará um erro e retornará FALSE.

Comentários

Cada byte na matriz à qual paResults aponta corresponde a um pixel no bitmap. Para cada pixel, o driver determina se seu valor de cor está na gama do dispositivo e grava um valor entre zero e 255 no byte de matriz correspondente. Os valores têm os seguintes significados:

Valor Significado
Zero A cor está na gama do dispositivo.
Diferentes de zero A cor está fora da gama. Um valor de n+1 indica que a cor está pelo menos tão distante da gama quanto um valor de n.
 

DrvIcmCheckBitmapBits pode ser implementado opcionalmente em drivers que dão suporte ao ICM. Um driver indica suporte para ICM definindo o sinalizador GCAPS_ICM no membro flGraphicsCaps da estrutura DEVINFO .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

DrvIcmCreateColorTransform