Fonction DrvIcmCheckBitmapBits (winddi.h)

Article
03/04/2024

La fonction DrvIcmCheckBitmapBitBits vérifie si les pixels de l’image bitmap spécifiée se trouvent dans la gamme d’appareils de la transformation spécifiée.

Syntaxe

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

Paramètres

dhpdev

Gérez le PDEV de l’appareil physique.

hColorTransform

Gérez la transformation de couleur par rapport à laquelle l’image bitmap doit être vérifiée. Cette transformation a été créée par le pilote via un appel précédent à sa routine DrvIcmCreateColorTransform .

pso

Pointeur vers le SURFOBJ qui contient la surface bitmap à vérifier.

paResults

Pointeur vers un tableau d’octets dans lequel le pilote retourne les résultats des tests. GDI alloue cette mémoire tampon pour contenir au moins autant d’octets que de pixels dans la bitmap. Le pilote n’a pas besoin d’effectuer d’allocation ou de vérification liée avant d’écrire dans le tableau.

Valeur retournée

DrvIcmCheckBitmapBitBits retourne TRUE en cas de réussite. Sinon, il signale une erreur et retourne FALSE.

Remarques

Chaque octet du tableau auquel les points paResults correspond à un pixel dans la bitmap. Pour chaque pixel, le pilote détermine si sa valeur de couleur se trouve dans le gamut de l’appareil, puis écrit une valeur comprise entre zéro et 255 dans l’octet du tableau correspondant. Les valeurs ont les significations suivantes :

Valeur	Signification
Zéro	La couleur se trouve dans le gamut de l’appareil.
Non nul	La couleur est en dehors du gamut. La valeur n+1 indique que la couleur est au moins aussi éloignée de la gamme qu’une valeur de n.

DrvIcmCheckBitmapBits peut être implémenté éventuellement dans les pilotes qui prennent en charge ICM. Un pilote indique la prise en charge d’ICM en définissant l’indicateur GCAPS_ICM dans le membre flGraphicsCaps de la structure DEVINFO .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

DrvIcmCreateColorTransform

Partager via