CMCreateProfile-Funktion (icm.h)

[CMCreateProfile ist nicht mehr für die Verwendung ab Windows Vista verfügbar.]

Erstellt ein Anzeigefarbprofil aus einer LOGCOLORSPACEA-Struktur .

Syntax

BOOL CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

Die Parameter

lpColorSpace

Zeiger auf einen logischen Farbraum, dessen Element "lcsFilename " NULL ist.

lpProfileData

Zeiger auf einen Zeiger auf einen Puffer. Wenn die Funktion erfolgreich verläuft, wird dieser Puffer zugewiesen und gefüllt. Es liegt in der Verantwortung der aufrufenden Anwendung, diesen Puffer frei zu geben, wenn er nicht mehr benötigt wird.

Rückgabewert

Ab Windows Vista gibt der Standard-CMM (Icm32.dll) FALSE zurück, und GetLastError meldet ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP und Windows 2000:

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

Wenn diese Funktion fehlschlägt, lautet der Rückgabewert FALSCH. Rufen Sie GetLastError auf, um den Fehler abzurufen.

Bemerkungen

Ab Windows Vista sind CMM-Implementoren nicht mehr erforderlich, um diese Methode zu implementieren.

Windows Server 2003, Windows XP und Windows 2000:

Die Unicode-Version dieser Funktion ist CMCreateProfileW.

Nur das Windows-Standard-CMM ist erforderlich, um diese Funktion zu exportieren. sie ist für alle anderen CMMs optional.

Wenn ein CMM CMCreateProfile nicht unterstützt, verwendet Windows das Standard-CMM zum Erstellen des Profils.

Das CMM sollte alle Kopfzeilenfelder auf vernünftige Standardwerte festlegen. Dieses Profil sollte als Eingabeprofil in einer Transformation verwendet werden können.

Die aufrufende Anwendung muss den von dieser Funktion zugeordneten Puffer freigeben und auf den lpProfileData-Parameter verweisen. Verwenden Sie GlobalFree , um den Puffer freizuspeichern.

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen
• CMCreateProfileW