DrvIcmCheckBitmapBits-Funktion (winddi.h)
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) |