Freigeben über

CreateProfileFromLogColorSpaceW-Funktion (icm.h)

  • Artikel

Konvertiert einen logischen Farbraum in ein Geräteprofil.

Syntax

BOOL CreateProfileFromLogColorSpaceW(
  LPLOGCOLORSPACEW pLogColorSpace,
  PBYTE            *pProfile
);

Parameter

pLogColorSpace

Ein Zeiger auf eine logische Farbraumstruktur. Weitere Informationen finden Sie unter LOGCOLORSPACEA . Der lcsFilename [0]-Member der -Struktur muss auf das NULL-Zeichen ("\0") festgelegt werden, andernfalls schlägt dieser Funktionsaufruf 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 ordnet den Puffer zu und füllt ihn mit Profilinformationen, wenn er erfolgreich ist. 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 pLogColorSpace verweist , nicht "\0" ist, 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. Andernfalls tritt ein Speicherverlust auf. Die GlobalFree-Funktion sollte verwendet werden, um diesen Puffer frei zu geben.

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

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

Weitere Informationen