GetColorProfileHeader-Funktion (icm.h)
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 |