Compartir a través de

Función DrvIcmCheckBitmapBits (winddi.h)

  • Artículo

La función DrvIcmCheckBitmapBits comprueba si los píxeles del mapa de bits especificado se encuentran dentro de la gama de dispositivos de la transformación especificada.

Sintaxis

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

Parámetros

dhpdev

Controle el PDEV del dispositivo físico.

hColorTransform

Identificador de la transformación de color en la que se va a comprobar el mapa de bits. El controlador creó esta transformación a través de una llamada anterior a su rutina DrvIcmCreateColorTransform .

pso

Puntero al SURFOBJ que contiene la superficie de mapa de bits que se va a comprobar.

paResults

Puntero a una matriz de bytes en la que el controlador devuelve los resultados de la prueba. GDI asigna este búfer para que contenga al menos tantos bytes como píxeles en el mapa de bits. El controlador no necesita realizar ninguna comprobación de asignación o límite antes de escribir en la matriz.

Valor devuelto

DrvIcmCheckBitmapBits devuelve TRUE cuando se realiza correctamente. De lo contrario, notifica un error y devuelve FALSE.

Comentarios

Cada byte de la matriz a la que se corresponden los puntos paResults con un píxel en el mapa de bits. Para cada píxel, el controlador determina si su valor de color está en la gama del dispositivo y, a continuación, escribe un valor entre cero y 255 en el byte de matriz correspondiente. Los valores tienen los significados siguientes:

Valor Significado
Cero El color está en la gama de dispositivos.
Distinto a cero El color está fuera de la gama. Un valor de n+1 indica que el color es al menos tan lejos de la gama como un valor de n.
 

DrvIcmCheckBitmapBits se puede implementar opcionalmente en los controladores que admiten ICM. Un controlador indica la compatibilidad con ICM estableciendo la marca GCAPS_ICM en el miembro flGraphicsCaps de la estructura DEVINFO .

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado winddi.h (incluya Winddi.h)

Consulte también

DrvIcmCreateColorTransform