CreateProfileFromLogColorSpaceA-Funktion (icm.h)

Konvertiert einen logischen Farbraum in ein Geräteprofil.

Syntax

BOOL CreateProfileFromLogColorSpaceA(
  LPLOGCOLORSPACEA pLogColorSpace,
  PBYTE            *pProfile
);

Parameter

pLogColorSpace

Ein Zeiger auf eine logische Farbraumstruktur. Details finden Sie unter LOGCOLORSPACEA . Das lcsFilename [0]-Element der Struktur muss auf das Nullzeichen ('\0') festgelegt werden, oder dieser Funktionsaufruf schlägt mit dem Rückgabewert von INVALID_PARAMETER fehl.

pProfile

Ein Zeiger auf einen Zeiger auf einen Puffer, in dem das Geräteprofil erstellt wird. Diese Funktion weist den Puffer zu und füllt ihn bei erfolgreicher Ausführung mit Profilinformationen aus. Wenn nicht, wird der Zeiger auf NULL festgelegt. Der Aufrufer ist dafür verantwortlich, diesen Puffer freizuweisen, wenn er nicht mehr benötigt wird.

Rückgabewert

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

Wenn diese Funktion fehlschlägt, lautet der Rückgabewert FALSCH.

Wenn das lcsFilename [0]-Element, wenn die LOGCOLORSPACEA-Struktur , auf die von pLogColorSpace verweist, nicht "\0" lautet, gibt diese Funktion INVALID_PARAMETER zurück.

Bemerkungen

Diese Funktion kann mit ASCII- oder Unicode-Zeichenfolgen verwendet werden. Der von dieser Funktion erstellte Puffer muss vom Aufrufer freigegeben werden, wenn er nicht mehr benötigt wird oder ein Speicherverlust auftritt. Verwenden Sie die GlobalHandle-Funktion , um den Handle für den Puffer abzurufen, und verwenden Sie dann die GlobalFree-Funktion , um den Handle frei zu geben.

Diese Funktion unterstützt keine Windows Farbsystemprofile (WCS)-Profile CAMP, DMP und GMMP.

Requirements

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen
• GlobalFree
• GlobalHandle