CMCreateDeviceLinkProfile-Funktion (icm.h)

Erstellt ein Gerätelinkprofil im Format, das vom International Color Consortium in seiner ICC-Profilformatspezifikation angegeben wird.

Syntax

BOOL CMCreateDeviceLinkProfile(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags,
  LPBYTE    *lpProfileData
);

Die Parameter

pahProfiles

Zeigen Sie auf ein Array von Profilziehpunkten.

nProfiles

Gibt die Anzahl der Profile im Array an.

padwIntents

Ein Array von Renderingabsichten.

nIntents

Die Anzahl der Elemente im Array von Absichten.

dwFlags

Gibt Kennzeichnungen an, die zum Erstellen der Steuerung der Transformation verwendet werden sollen. Ausführliche Informationen finden Sie unter CMM Transform Creation Flags.

lpProfileData

Zeiger auf einen Zeiger auf einen Puffer. Wenn die Funktion erfolgreich verläuft, wird dieser Puffer zugewiesen und gefüllt. Die aufrufende Anwendung muss diesen Puffer freigeben, wenn er nicht mehr benötigt wird. Verwenden Sie die GlobalFree-Funktion , um diesen Puffer freizusprechen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert null. Wenn die Funktion nicht erfolgreich ist, sollte der CMM SetLastError aufrufen, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, der in Winerror.h definiert ist.

Bemerkungen

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

Wenn ein CMM CMCreateDeviceLinkProfile nicht unterstützt, verwendet Windows das Standard-CMM zum Erstellen eines Gerätelinkprofils.

Die ersten und die letzten Profile im Array müssen Geräteprofile sein. Die anderen Profile können Farbraum oder abstrakte Profile sein. Der Ausgabefarbraum jedes Profils muss der Eingabefarbbereich des nächsten Profils sein.

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

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen
• GlobalFree