Funzione DrvIcmCheckBitmapBits (winddi.h)

La funzione DrvIcmCheckBitmapBits verifica se i pixel nella bitmap specificata si trovano nella gamma del dispositivo della trasformazione specificata.

Sintassi

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

Parametri

dhpdev

Gestire il PDEV del dispositivo fisico.

hColorTransform

Gestire la trasformazione del colore in base alla quale deve essere controllata la bitmap. Questa trasformazione è stata creata dal driver tramite una chiamata precedente alla routine DrvIcmCreateColorTransform .

pso

Puntatore al SURFOBJ che contiene la superficie bitmap da controllare.

paResults

Puntatore a una matrice di byte in cui il driver restituisce i risultati del test. GDI alloca questo buffer per contenere almeno quanti byte sono presenti pixel nella bitmap. Il driver non deve eseguire alcun controllo di allocazione o di associazione prima di scrivere nella matrice.

Valore restituito

DrvIcmCheckBitmapBits restituisceTRUE al successo. In caso contrario, segnala un errore e restituisce FALSE.

Commenti

Ogni byte nella matrice a cui i punti paResults corrisponde a un pixel nella bitmap. Per ogni pixel, il driver determina se il relativo valore di colore si trova nel gamut del dispositivo e quindi scrive un valore compreso tra zero e 255 nel byte di matrice corrispondente. I valori hanno i significati seguenti:

DrvIcmCheckBitmapBits può essere implementato facoltativamente nei driver che supportano ICM. Un driver indica il supporto per ICM impostando il flag GCAPS_ICM nel membro flGraphicsCaps della struttura DEVINFO .

Requisiti

Vedi anche

DrvIcmCreateColorTransform