SetColorProfileElement-Funktion (icm.h)

Artikel
08/24/2023

Legt die Elementdaten für ein markiertes Profilelement in einem ICC-Farbprofil fest.

Syntax

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

Parameter

hProfile

Gibt ein Handle für das betreffende ICC-Profil an.

tag

Identifiziert das markierte Element.

dwOffset

Gibt den Offset aus dem ersten Byte der markierten Elementdaten an, an denen mit dem Schreiben begonnen werden soll.

pcbElement

Zeiger auf eine Variable, die die Anzahl der zu schreibenden Daten in Bytes enthält. Bei der Rückgabe enthält sie die Anzahl der tatsächlich geschriebenen Bytes.

pElement

Zeiger auf einen Puffer, der die Daten enthält, die in das markierte Element im Farbprofil geschrieben werden sollen.

Rückgabewert

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

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Diese Funktion schlägt fehl, wenn hProfile kein gültiges ICC-Profil ist.

Wenn das Farbprofil nicht für Lese-/Schreibberechtigungen geöffnet wird, schlägt diese Funktion fehl.

Wenn dwOffset die für das angegebene markierte Element festgelegte Größe überschreitet, schlägt diese Funktion fehl.

Wenn dwOffset + *pcbSize größer als die Größe des angegebenen Elements ist, schreibt diese Funktion nur so viele Bytes, wie in die aktuelle Größe des Elements passen.

Alle vorhandenen Daten im angegebenen Teil des markierten Elements werden überschrieben, wenn diese Funktion erfolgreich ist.

Diese Funktion unterstützt keine WCS-Profile (Windows Color System) CAMP, DMP und GMMP. da Profilelemente implizit mit ICC-Tagtypen verknüpft und hartcodiert sind und viele robuste XML-Analysebibliotheken vorhanden sind.

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