CMCreateDeviceLinkProfile-Funktion (icm.h)

Artikel
08/24/2023

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

Syntax

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

Parameter

pahProfiles

Zeiger auf ein Array von Profilhandles.

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 Flags an, die für die Erstellung der Transformation verwendet werden sollen. Weitere Informationen finden Sie unter Flags zur Erstellung von CMM-Transformationen.

lpProfileData

Zeiger auf einen Zeiger auf einen Puffer. Bei erfolgreicher Ausführung ordnet die Funktion diesen Puffer zu und füllt diesen aus. Die aufrufende Anwendung muss diesen Puffer freigeben, wenn er nicht mehr benötigt wird. Verwenden Sie die GlobalFree-Funktion , um diesen Puffer frei zu geben.

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.

Hinweise

Zum Exportieren dieser Funktion ist nur der Windows-Standard-CMM erforderlich. sie ist für alle anderen CMMs optional.

Wenn ein CMM CMCreateDeviceLinkProfile nicht unterstützt, verwendet Windows den Standard-CMM, um ein Gerätelinkprofil zu erstellen.

Das erste und das letzte Profil im Array müssen Geräteprofile sein. Die anderen Profile können Farbraum oder abstrakte Profile sein. Der Ausgabefarbraum jedes Profils muss der Eingabefarbraum des nächsten Profils sein.

Die aufrufende Anwendung muss den puffer freigeben, der von dieser Funktion zugeordnet ist und mit dem lpProfileData-Parameter darauf verweist. Verwenden Sie die GlobalFree-Funktion , um den Puffer frei zu geben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h

Freigeben über