DrvIcmCreateColorTransform-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvIcmCreateColorTransform-Funktion erstellt eine ICM-Farbtransformation.

Syntax

HANDLE DrvIcmCreateColorTransform(
  [in]           DHPDEV           dhpdev,
  [in]           LPLOGCOLORSPACEW pLogColorSpace,
  [in, optional] PVOID            pvSourceProfile,
  [in]           ULONG            cjSourceProfile,
  [in]           PVOID            pvDestProfile,
  [in]           ULONG            cjDestProfile,
  [in, optional] PVOID            pvTargetProfile,
  [in]           ULONG            cjTargetProfile,
  [in]           DWORD            dwReserved
);

Parameter

[in] dhpdev

Handle zum PDEV des physischen Geräts.

[in] pLogColorSpace

Zeiger auf eine logische Farbraumstruktur. Die LOGCOLORSPACEW-Struktur ist in der Microsoft Windows SDK Dokumentation definiert. Der Treiber sollte Informationen zum Quellfarbraum aus dieser Struktur abrufen, wenn pvSourceProfileNULL ist.

[in, optional] pvSourceProfile

Zeiger auf die Speicherzuordnung des Quellprofils. Dieser Parameter kann NULL sein.

[in] cjSourceProfile

Gibt die Größe der Speicherzuordnung des Quellprofils in Byte an. Wenn pvSourceProfileNULL ist, sollte dieser Parameter auf Null festgelegt werden.

[in] pvDestProfile

Zeiger auf die Speicherzuordnung des Zielprofils.

[in] cjDestProfile

Gibt die Größe der Speicherzuordnung des Zielprofils in Bytes an.

[in, optional] pvTargetProfile

Zeiger auf die Speicherzuordnung des Zielprofils. Dieser Parameter kann NULL sein.

[in] cjTargetProfile

Gibt die Größe der Speicherzuordnung des Zielprofils in Byte an. Wenn pvTargetProfileNULL ist, sollte dieser Parameter auf Null festgelegt werden.

[in] dwReserved

Reservierter Parameter, der auf 0 (null) festgelegt werden soll.

Rückgabewert

DrvIcmCreateColorTransform gibt bei Erfolg ein Handle an die erstellte Transformation zurück. Andernfalls wird ein Fehler gemeldet und NULL zurückgegeben.

Hinweise

Der Treiber erstellt eine Farbtransformation aus den Profildaten wie folgt:

Der Treiber sollte das Quellprofil verwenden, auf das pvSourceProfile zeigt, wenn es nicht NULL ist. Andernfalls sollte der Treiber die Daten in der Struktur verwenden, auf die pLogColorSpace für Quellfarbrauminformationen verweist.
Wenn der Treiber ein Zielprofil, aber kein Zielprofil empfängt, sollte er die Daten speichern, die zum Transformieren von Farben aus dem angegebenen Quellfarbraum in den angegebenen Zielfarbraum erforderlich sind.
Wenn der Treiber sowohl Ziel- als auch Zielprofile empfängt, sollte er die Daten speichern, die zum Transformieren von Farben aus dem angegebenen Quellfarbraum in den angegebenen Zielfarbraum und vom Zielfarbraum zurück in den Zielfarbraum erforderlich sind. In diesem Szenario ist das Gerät des Treibers das Zielgerät, auf dem ein Image überprüft werden kann. Der Treiber muss dann in der Lage sein, den Farbraum des Korrekturhilfebilds in den Farbraum des Zielgeräts zu konvertieren.

Unabhängig davon, ob ein Zielprofil angegeben wird, ist das Gerät des Treibers immer das Zielgerät.

Die bereitgestellten Profile entsprechen Der Version 2.10 des ICC-Profilformats. Wenn der Treiber das angegebene Format nicht versteht, sollte der Aufruf fehlschlagen.

Der Treiber kann sicher auf die gesamte Speicherzuordnung jedes Profils zugreifen. Die Zeiger pvSourceProfile, pvDestProfile und pvTargetProfile sind nur während des Bereichs des Aufrufs von DrvIcmCreateTransform gültig.

Treiber, die ICM-Unterstützung melden, sollten diese Funktion implementieren. 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

DrvIcmDeleteColorTransform

Share via