Freigeben über

CreateProfileFromLogColorSpaceA-Funktion (icm.h)

  • Artikel

Konvertiert einen logischen Farbraum in ein Geräteprofil.

Syntax

BOOL CreateProfileFromLogColorSpaceA(
  LPLOGCOLORSPACEA pLogColorSpace,
  PBYTE            *pProfile
);

Parameter

pLogColorSpace

Ein Zeiger auf eine logische Farbraumstruktur. Weitere Informationen finden Sie unter LOGCOLORSPACEA . Das lcsFilename [0]-Element der Struktur muss auf das NULL-Zeichen ('\0') festgelegt werden, sonst schlägt dieser Funktionsaufruf mit dem Rückgabewert 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. Andernfalls wird der Zeiger auf NULL festgelegt. Der Aufrufer ist dafür verantwortlich, diesen Puffer frei zu geben, wenn er nicht mehr benötigt wird.

Rückgabewert

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

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.

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

Hinweise

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, da es sonst zu einem Speicherverlust kommt. Die GlobalFree-Funktion sollte verwendet werden, um diesen Puffer frei zu machen.

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

Anforderungen

   
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

Weitere Informationen