WcsOpenColorProfileW-Funktion (icm.h)

  • Artikel

Erstellt ein Handle für ein angegebenes Farbprofil.

Syntax

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

Parameter

pCDMPProfile

Zeiger auf einen WCS-DMP oder eine ICC-Farbprofilstruktur, die das Profil angibt. Sie können den pCDMPProfile-Zeiger freigeben, nachdem Sie das Handle erstellt haben. Wenn das Profil ICC ist und sein dwType-Member auf DONT_USE_EMBEDDED_WCS_PROFILES festgelegt ist, ignoriert WcsOpenColorProfile alle eingebetteten WCS-Profile innerhalb des ICC-Profils.

pCAMPProfile

Ein Zeiger auf eine Profilstruktur, die ein WCS-Farbdarstellungsmodellprofil (CAMP) angibt. Sie können den pCAMPProfile-Zeiger freigeben, nachdem Sie den Handle erstellt haben. Bei NULL wird das STANDARD-CAMP verwendet, und die aktuelle Benutzereinstellung WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER wird beim Abfragen des STANDARD-CAMP verwendet.

pGMMPProfile

Ein Zeiger auf eine Profilstruktur, die ein WCS Gamut Map Model Profile (GMMP) angibt. Sie können den pGMMPProfile-Zeiger freigeben, nachdem Sie das Handle erstellt haben. Bei NULL wird der Standard-GMMP für die Standardrenderingabsicht verwendet, und die aktuelle Benutzereinstellung WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER wird beim Abfragen des Standard-GMMP verwendet. Eine Beschreibung der Renderingabsichten finden Sie unter Renderabsichten.

dwDesireAccess

Ein Flagwert, der angibt, wie auf das angegebene Farbprofil zugegriffen werden soll. Dieser Parameter muss einen der folgenden Werte annehmen:

Wert BESCHREIBUNG
PROFILE_READ Gibt an, dass das Farbprofil für schreibgeschützten Zugriff geöffnet wird.
PROFILE_READWRITE Gibt an, dass das Farbprofil sowohl für lese- als auch für schreibzugriff geöffnet wird. Der Wert dieses Flags wird ignoriert, wenn das Profil ein WCS-Profil ist.

dwShareMode

Ein Flagwert, der Aktionen angibt, die beim Öffnen eines in einer Datei enthaltenen Farbprofils ausgeführt werden sollen. Dieser Parameter muss einen der folgenden Werte annehmen, die in winnt.h definiert sind:

Wert BESCHREIBUNG
FILE_SHARE_READ Gibt an, dass Sie weitere geöffnete Vorgänge (für Lesezugriff) für das Profil ausführen können.
FILE_SHARE_WRITE Gibt an, dass Sie weitere offene Vorgänge (für Schreibzugriff) für das Profil ausführen können. Dieser Flagwert wird ignoriert, wenn ein WCS-Profil geöffnet wird.

dwCreationMode

Ein Flagwert, der die Aktionen angibt, die beim Öffnen eines Farbprofils ausgeführt werden sollen, wenn es in einer Datei enthalten ist. Dieser Parameter muss einen der folgenden Werte annehmen, die in winbase.h definiert sind:

Wert BESCHREIBUNG
CREATE_NEW Gibt an, dass ein neues Profil erstellt wird. Diese Funktion schlägt fehl, wenn das Profil bereits vorhanden ist.
CREATE_ALWAYS Gibt an, dass ein neues Profil erstellt wird. Wenn ein Profil bereits vorhanden ist, wird es überschrieben.
OPEN_EXISTING Gibt an, dass das Profil geöffnet wird. Diese Funktion schlägt fehl, wenn das Profil nicht vorhanden ist.
OPEN_ALWAYS Gibt an, dass das Profil geöffnet werden soll, wenn eine ICC-Datei (International Color Consortium) vorhanden ist. Wenn kein ICC-Profil vorhanden ist, erstellt WCS ein neues ICC-Profil. Die Funktion schlägt für WCS-Profile fehl, wenn dieses Flag festgelegt ist und kein WCS-Profil vorhanden ist.
TRUNCATE_EXISTING Gibt an, dass das Profil geöffnet und auf null Bytes abgeschnitten werden soll. Die Funktion schlägt fehl, wenn das Profil nicht vorhanden ist.

dwFlags

Ein Flagwert, der angibt, ob das eingebettete WCS-Profil verwendet werden soll. Dieser Parameter hat keine Auswirkung, es sei denn , pCDMProfile gibt ein ICC-Profil an, das ein eingebettetes WCS-Profil enthält.

Dieser Parameter akzeptiert einen der folgenden Werte:

Wert BESCHREIBUNG
0 Gibt an, dass das eingebettete WCS-Profil verwendet und das von pCDMPProfile angegebene ICC-Profil ignoriert wird.
DONT_USE_EMBEDDED_WCS_PROFILES Gibt an, dass das durch pCDMPProfile angegebene ICC-Profil verwendet und das eingebettete WCS-Profil ignoriert wird.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert das Handle des geöffneten Farbprofils.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert NULL.

Hinweise

Diese API verwendet einen Satz von DMP, CAMP und GMMP und gibt ein WCS-Profilhandle zurück. NULL-Werte für GMMP sind gültig. Ein NULL-Wert für CAMP wird durch den CAMP-Standardwert ersetzt.

Diese API akzeptiert auch ICC-Profile. Die Verwendung eines ICC-Profils garantiert keine Verarbeitung durch die WCS CITE-Engine. Die WCS-Engine wird nur verwendet, wenn mindestens ein WCS-Profil übergeben wird. Reine ICC-Workflows sind mit dem Legacyverhalten konsistent.

Sie können das Von dieser Funktion zurückgegebene Handle in anderen Farbprofilverwaltungsfunktionen verwenden.

Die dwCreationMode-Flags CREATE_NEW, CREATE_ALWAYS und TRUNCATE_EXISTING geben immer leere ICC-HPROFILEs zurück. Wenn andere dwCreationMode-Flags vorhanden sind, bestimmt die Funktion, ob das Profil ICC oder WCS XML ist.

Innerhalb des ICC-Codepfads wird ein ICC-HPROFILE mithilfe der angeforderten Freigabe-, Zugriffs- und Erstellungsflags zurückgegeben, wie in den obigen Tabellen angegeben.

Innerhalb des WCS-Pfads schlägt das dwationCreationMode-Flag OPEN_ALWAYS fehl, wenn das Profil nicht vorhanden ist, da WCS-Profile nicht innerhalb der WCS-Architektur erstellt oder bearbeitet werden können (sie müssen außerhalb des Profils mit MSXML6 bearbeitet werden). Aus dem gleichen Grund werden dwShareMode-Flag FILE_SHARE_WRITE und das dwDesiredAccess-Flag PROFILE_READWRITE innerhalb des WCS-Pfads ignoriert.

Nachdem das Handle für das Farbprofil erstellt wurde, können alle Informationen, die zum Erstellen dieses Handles verwendet werden, gelöscht werden.

Verwenden Sie die CloseColorProfile-Funktion , um ein Objekthandle zu schließen, das von WcsOpenColorProfile zurückgegeben wird.

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