GetColorProfileHeader-Funktion (icm.h)

Artikel
02/26/2024

Ruft die ICC-Headerstruktur entweder vom ICC-Farbprofil oder vom WCS-XML-Profil ab oder leitet sie ab. Treiber und Anwendungen sollten davon ausgehen, dass die Rückgabe von TRUE nur angibt, dass ein ordnungsgemäß strukturierter Header zurückgegeben wird. Jedes Tag muss weiterhin unabhängig mithilfe von Legacy-ICM2-APIs oder XML-Schema-APIs überprüft werden.

Syntax

BOOL GetColorProfileHeader(
  HPROFILE       hProfile,
  PPROFILEHEADER pHeader
);

Parameter

hProfile

Gibt ein Handle für das betreffende Farbprofil an.

pHeader

Zeigt auf eine Variable, in der die ICC-Headerstruktur platziert werden soll.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Diese Funktion schlägt fehl, ist ein ungültiges ICC- oder WCS-XML-Profil, auf das im hProfile-Parameter verwiesen wird. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Um zu ermitteln, ob der Header von einem ICC- oder DMP-Profilhandle abgeleitet ist, überprüfen Sie die Headersignatur (Headerbyte 36-39). Wenn die Signatur "acsp" (big endian) ist, wurde ein ICC-Profil verwendet. Wenn die Signatur "cdmp" (big-endian) lautet, wurde ein DMP verwendet.

Die Merkmale, die einen Header als "synthetisiert" für einen WCS-DMP identifizieren, sind:

pIcmProfileHeader-phSignature> = 'pmdc' (little endian = big endian 'cdmp')

pIcmProfileHeader-phCMMType> = '1scw' (little endian = big endian 'wcs1').

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h
Bibliothek	Mscms.lib
DLL	Mscms.dll

Freigeben über