Freigeben über

CreateDeviceLinkProfile-Funktion (icm.h)

  • Artikel

Erstellt ein ICC-Gerätelinkprofil (International Color Consortium) aus einer Reihe von Farbprofilen unter Verwendung der angegebenen Absichten.

Syntax

BOOL CreateDeviceLinkProfile(
  PHPROFILE hProfile,
  DWORD     nProfiles,
  PDWORD    padwIntent,
  DWORD     nIntents,
  DWORD     dwFlags,
  PBYTE     *pProfileData,
  DWORD     indexPreferredCMM
);

Parameter

hProfile

Zeiger auf ein Array von Handles der zu verwendenden Farbprofile. Die Funktion bestimmt, ob die HPROFILEs ICC-Profilinformationen enthalten, und verarbeitet diese ggf. entsprechend.

nProfiles

Gibt die Anzahl von Profilen im Array an, auf das hProfile verweist.

padwIntent

Zeiger auf ein Array von DWORDS, das die zu verwendenden Absichten enthält. Weitere Informationen finden Sie unter Renderingabsichten.

nIntents

Die Anzahl der Absichten im Array, auf die von padwIntent verwiesen wird.

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.

pProfileData

Zeiger auf einen Zeiger auf einen Puffer. Bei erfolgreicher Ausführung ordnet diese Funktion den Puffer zu, platziert seine Adresse in *pProfileData und füllt ihn mit einem Geräteverknüpfungsprofil aus. Wenn die Funktion erfolgreich ist, muss die aufrufende Anwendung den Puffer freigeben, nachdem er nicht mehr benötigt wird.

indexPreferredCMM

Gibt den einbasierten Index des Farbprofils an, der angibt, welches Farbverwaltungsmodul (CMM) verwendet werden soll. Der Anwendungsentwickler kann Windows erlauben, den CMM auszuwählen, indem er diesen Parameter auf INDEX_DONT_CARE festlegt. Weitere Informationen finden Sie unter Verwenden von Farbverwaltungsmodulen (CMM).

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Für HPROFILEs, die WCS-Profilinformationen enthalten, werden die HPROFILEs in gültige ICC-Profilhandles konvertiert, und dann werden diese ICC-Profilhandles zum Erstellen des Geräteverknüpfungsprofils verwendet.

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 auf den der pProfileData-Parameter verweist. Die GlobalFree-Funktion sollte verwendet werden, 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
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen