Share via

DrvIcmCheckBitmapBits-Funktion (winddi.h)

  • Artikel

Die DrvIcmCheckBitmapBits-Funktion überprüft, ob die Pixel in der angegebenen Bitmap innerhalb der Geräteskala der angegebenen Transformation liegen.

Syntax

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

Parameter

dhpdev

Handle zum PDEV des physischen Geräts.

hColorTransform

Handle für die Farbtransformation, für die die Bitmap überprüft werden soll. Diese Transformation wurde vom Treiber durch einen vorherigen Aufruf seiner DrvIcmCreateColorTransform-Routine erstellt.

pso

Zeiger auf die SURFOBJ , die die zu überprüfende Bitmapoberfläche enthält.

paResults

Zeiger auf ein Bytearray, in dem der Treiber die Testergebnisse zurückgibt. GDI ordnet diesen Puffer zu, um mindestens so viele Bytes zu enthalten, wie pixel in der Bitmap vorhanden sind. Der Treiber muss vor dem Schreiben in das Array keine Zuordnungs- oder gebundenen Überprüfungen durchführen.

Rückgabewert

DrvIcmCheckBitmapBits gibt bei Erfolg TRUE zurück. Andernfalls wird ein Fehler gemeldet und FALSE zurückgegeben.

Hinweise

Jedes Byte im Array, dem paResults-Punkte entsprechen, einem Pixel in der Bitmap. Für jedes Pixel bestimmt der Treiber, ob der Farbwert im Geräteumfang liegt, und schreibt dann einen Wert zwischen 0 und 255 in das entsprechende Arraybyte. Die Werte haben die folgende Bedeutung:

Wert Bedeutung
Null Die Farbe befindet sich im Geräteumfang.
Nonzero Die Farbe liegt außerhalb des Farbraums. Der Wert n+1 gibt an, dass die Farbe mindestens so weit außerhalb des Farbraums liegt wie der Wert n.
 

DrvIcmCheckBitmapBits kann optional in Treibern implementiert werden, die ICM unterstützen. Ein Treiber gibt die Unterstützung für ICM an, indem das flag GCAPS_ICM im flGraphicsCaps-Member der DEVINFO-Struktur festgelegt wird.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvIcmCreateColorTransform