Profilverwaltungsfunktionen

Profilverwaltungsfunktionen

Die folgenden API-Funktionen sind in der Profilverwaltung nützlich.

Funktion	Beschreibung
AssociateColorProfileWithDeviceW-	Ordnet ein angegebenes Farbprofil einem angegebenen Gerät zu.
[CreateProfileFromLogColorSpaceW]((/windows/win32/api/icm/nf-icm-createprofilefromlogcolorspacew)	Wandelt einen logischen Farbraum in ein Geräteprofilum.
DisassociateColorProfileFromDeviceW	Zuordnen eines angegebenen Farbprofils zu einem angegebenen Gerät auf einem angegebenen Computer.
EnumColorProfilesW	Listet alle Profile auf, die die angegebenen Enumerationskriterien erfüllen.
GetColorDirectoryW-	Ruft den Pfad des Windows COLOR-Verzeichnisses auf einem angegebenen Computer ab.
GetDeviceGammaRamp	Ruft die Gammahierarchie von direkten Farbanzeigetafeln ab.
GetStandardColorSpaceProfileW-	Ruft das Farbprofil ab, das für den angegebenen Standardfarbraum registriert ist.
InstallColorProfileW-	Installiert ein bestimmtes Profil für die Verwendung auf einem angegebenen Computer. Das Profil wird auch in das COLOR-Verzeichnis kopiert.
RegisterCMMW-	Ordnet einen angegebenen Identifikationswert der angegebenen Farbverwaltungsmodul-Dynamic Link Library (CMM DLL) zu. Wenn diese ID in einem Farbprofil angezeigt wird, kann Windows dann das entsprechende CMM suchen, um eine Transformation zu erstellen.
SetDeviceGammaRamp-	Legt die Gammahierarchie auf Direct Color Display Boards fest.
SetStandardColorSpaceProfileW	Registriert ein angegebenes Profil für einen bestimmten StandardFarbraum. Das Profil kann mit GetStandardColorSpaceProfileWabgefragt werden.
UninstallColorProfileW-	Entfernt ein angegebenes Farbprofil von einem angegebenen Computer. Zugeordnete Dateien werden optional aus dem System gelöscht.
Aufheben der RegistrierungCMMW-	Entfernt einen angegebenen ID-Wert von einer bestimmten Farbverwaltungsmodul-Dynamic Link Library (CMM DLL).
WcsAssociateColorProfileWithDevice	Ordnet ein angegebenes WCS-Farbprofil einem angegebenen Gerät zu.
WcsCreateIccProfile	Wandelt ein WCS-Profil in ein ICC-Profil um.
WcsDisassociateColorProfileFromDevice	Zuordnen eines angegebenen WCS-Farbprofils zu einem angegebenen Gerät auf einem angegebenen Computer.
WcsEnumColorProfiles	Listet alle Farbprofile auf, die die Enumerationskriterien im angegebenen Profilverwaltungsbereich erfüllen.
WcsEnumColorProfilesSize	Gibt die Größe des Puffers in Bytes zurück, der von der WcsEnumColorProfiles Funktion zum Aufzählen von Farbprofilen erforderlich ist.
WcsGetDefaultColorProfile	Ruft das Standardfarbprofil für ein Gerät oder den geräteunabhängigen Standardwert ab, wenn das Gerät nicht angegeben ist.
WcsGetDefaultColorProfileSize	Gibt die Größe des Standardfarbprofilnamens für ein Gerät in Byte zurück, einschließlich des NULL- Terminator.
WcsGetDefaultRenderingIntent	Ruft die Standardrenderingabsicht im angegebenen Profilverwaltungsbereich ab.
WcsGetUsePerUserProfiles	Bestimmt, ob der Benutzer eine Benutzerprofilzuordnungsliste für das angegebene Gerät verwendet hat.
WcsOpenColorProfileW	Erstellt ein Handle für ein angegebenes Farbprofil.
WcsSetDefaultColorProfile	Legt den Standardfarbprofilnamen des angegebenen Profiltyps im angegebenen Profilverwaltungsbereich fest.
WcsSetDefaultRenderingIntent	Legt die Standardrenderingabsicht im angegebenen Profilverwaltungsbereich fest.
WcsSetUsePerUserProfiles	Ermöglicht dem Benutzer anzugeben, ob eine Benutzerprofilzuordnungsliste für das angegebene Gerät verwendet werden soll.

 

Profilverbrauchsfunktionen

Die Profilverbrauchs-APIs sind die APIs in ICM2, die ICC- oder WCS-XML-Profile, Profilhandles oder Renderabsichten als Parameter verwenden und eine Reihe neuer APIs für WCS-Profilunterstützung für Anwendungsfarbverwaltungscode verwenden.

 

Profile und Profilverwaltungsfunktionen

Der Profilverwaltungsworkflow basiert auf vorhandenen ICM2-APIs, die erweitert werden, um zusätzliche Funktionen zum Überarbeiten von Anwendungscode bereitzustellen.

Profile enthalten Informationen, die von Farbverarbeitungsalgorithmen zum Übersetzen von Farben zwischen verschiedenen Farbräumen verwendet werden. Die Profilverwaltung bietet eine Möglichkeit zum Abfragen und Angeben der Profile, die vom Farbverarbeitungsmodell verwendet werden, um die Farbausgabe verschiedener Peripheriegeräte mit unterschiedlichen Farbeigenschaften zu verwalten.

Die Profilverwaltung bietet die folgenden Funktionalitäten:

 

1. Installieren von Farbprofilen für die Verwendung im System.

 

2. Zuordnen eines oder mehrerer installierter Farbprofile zu einem bestimmten Gerät.

 

3. Auswählen eines Standardfarbprofils eines bestimmten Typs unter den Profilen, die für die Verwendung in einer bestimmten Phase der Farbverarbeitung verfügbar sind. Dies kann für ein Gerät zwischen den damit verbundenen Profilen oder unter den im System installierten Profilen und nicht gerätespezifisch sein.

 

4. Aufzählen von Farbprofilen, die bestimmte Kriterien zwischen den im System installierten Profilen erfüllen.

Die WCS-Profildateierweiterungen sind ".cdmp" für DMPs, ".camp" für CAMPs und ".gmmp" für GMMPs.

 

Verwaltung von Benutzerprofilen und Aktivieren der Ausführung im LUA-Kontext

Das Ziel des im aktuellen Dokument beschriebenen Entwurfs ist wie folgt:

 

1. Die Legacy-ICM2-Implementierung bietet keine Unterstützung für die Benutzerprofilverwaltung. Unterschiedliche Benutzer können keine eigenen Profileinstellungen haben. In Vista ermöglicht die WCS-Profilverwaltungsinfrastruktur Benutzern die Konfiguration einzelner Profileinstellungen für die meisten Funktionen.

 

2. Alle ICM2-Profilverwaltungs-APIs ändern einstellungen systemweit und erfordern Administratorrechte. In Windows Vista werden alle Benutzer in luA-Einstellungen (Least-Privileged User Account, Am häufigsten) ausgeführt, und Administratoren können die Rechte selektiv erhöhen, um Anwendungen auszuführen, die systemweite Einstellungen ändern. In der WCS-Profilverwaltung können alle Benutzerprofileinstellungen im LUA-Kontext konfiguriert werden. Profilverwaltungsanwendungen können als LUA-Einstellungen ausgeführt werden, deren Nutzungsbereich erhöhen und sicherstellen, dass die Sicherheit des Systems nicht beeinträchtigt wird.

Die Profilverwaltung in Vista bietet die folgenden Verbesserungen gegenüber der älteren ICM2-Infrastruktur:

 

1. Es ermöglicht die Profilzuordnung mit Geräten, Standardprofileinstellungen und Enumerationen von Profilen sowohl pro Benutzer als auch systemweit.

 

2. Die Installation eines Profils bleibt systemweit und erfordert Administratorrechte. Dies entspricht der Profilinstallation während der Geräteinstallation, da die Geräteinstallation systemweit ist und Administratorrechte erfordert.

 

Gibt an, ob Geräte aus dem LUA-Kontext installiert werden können, was für diese Geräteklasse unterstützt wird. In Vista ist es beispielsweise möglich, die Druckerinstallation aus dem LUA-Kontext durchzuführen, wenn dem Benutzer Rechte zum Kopieren von Dateien in den Treiberspeicher durch einen Domänenadministrator mithilfe von Treiberspeicherrichtlinien gewährt wurden. Die Farbprofilverwaltungsinfrastruktur muss in dieser Hinsicht nichts Besonderes tun, da die Installation im Spoolerkontext erfolgt.

 

3. Das Ändern von Profileinstellungen im Benutzerbereich kann im LUA-Kontext erfolgen; Systemweite Änderungen erfordern Administratorrechte. Profilverwaltungsvorgänge, die das Lesen von Konfigurationsinformationen erfordern, können im LUA-Kontext sowohl für benutzerspezifische als auch für systemweite Einstellungen ausgeführt werden.

Profilverwaltungsbereich gibt den Umfang der ausgeführten Vorgänge an; entweder pro Benutzer oder systemweit.

Für jeden Vorgang wird angegeben, ob er aus dem LUA-Kontext ausgeführt werden kann. Wenn ein Vorgang im LUA-Kontext nicht ausgeführt werden kann, gibt die entsprechende Profilverwaltungs-API fehler mit zugriff verweigert zurück. Anwendungen, die die API verwenden, z. B. die Farbverwaltungssteuerung, können es dem Benutzer ermöglichen, den verwaltungstechnischen Kontext (mithilfe von OTS oder Zustimmungs-UI) zu erhöhen, und dann die API aus dem erhöhten Kontext aufrufen, damit der Vorgang erfolgreich ausgeführt wird.

Operation

Profilverwaltungsbereich

Vorbedingung

Nach der Bedingung

Ausführbare Datei im LUA-Kontext

${ROWSPAN2}$Install Profil${REMOVE}$

Systemweit

Profil kopiert, in das System installiert und zur Verwendung verfügbar. Das Profil kann in systemweitem und aktuellem Benutzerbereich für alle Benutzer aufgezählt werden.

Während der Gerätetreiberinstallation unterliegen treiberinstallationsrichtlinien. Nein, andernfalls.

Aktueller Benutzer

Nicht unterstützt

${ROWSPAN2}$Uninstall Profil${REMOVE}$

Systemweit

Das Profil wird im System installiert.

Das vom System deinstallierte Profil und optional aus dem Profilspeicher gelöscht. Das Profil ist nicht mehr für die Verwendung verfügbar und kann in keinem Bereich aufgezählt werden.

Nein

Aktueller Benutzer

Nicht unterstützt

${ROWSPAN2}$Associate Profil mit gerät${REMOVE}$

Systemweit

Das Profil wird installiert und ist vom Typ ICC oder CDMP.

Profil steht für die Verwendung mit dem Gerät von allen Benutzern zur Verfügung. Es ist aufzählbar, im systemweiten Bereich und auch im aktuellen Benutzerbereich für alle Benutzer, wie dem Gerät zugeordnet.

Nein

Aktueller Benutzer

Das Profil wird installiert. Es spielt keine Rolle, ob das Profil bereits dem Gerät im systemweiten Umfang zugeordnet ist und vom Typ ICC oder CDMP stammt.

Das Profil steht für die Verwendung mit dem Gerät durch den aktuellen Benutzer zur Verfügung. Sie kann nur im aktuellen Benutzerbereich aufgezählt werden (es sei denn, es gibt auch eine systemweite Zuordnung), die dem Gerät zugeordnet ist.

Ja

${ROWSPAN2}$Disassociate Profil von device${REMOVE}$

Systemweit

Das Profil ist dem Gerät im systemweiten Bereich zugeordnet und hat den Typ ICC oder CDMP.

Das Profil ist nicht mehr für die Verwendung verfügbar (mit Ausnahme von Benutzern, die diese Zuordnung auch im aktuellen Benutzerbereich haben). Sie ist im systemweiten Bereich nicht aufgezählt. Es kann jedoch für einen Benutzer, der über diese Zuordnung verfügt, im aktuellen Benutzerbereich aufzählbar sein.

Nein

Aktueller Benutzer

Das Profil wird dem Gerät im aktuellen Benutzerbereich zugeordnet (unabhängig davon, ob es im systemweiten Bereich zugeordnet ist) und vom Typ ICC oder CDMP ist.

Das Profil ist nicht mehr für die Verwendung oder aufzählbar, die dem Gerät zugeordnet ist, durch den aktuellen Benutzer (es sei denn, es ist auch im systemweiten Bereich dem Gerät zugeordnet).

Ja

${ROWSPAN2}$Set Profil für einen Typ (DMP oder ICC) als Standard für ein Gerät${REMOVE}$

Systemweit

Profil vom Typ ICC oder CDMP

Das Profil wird standardmäßig für den bestimmten Typ mit dem Gerät für alle Benutzer verwendet, mit Ausnahme von Benutzern, die diese Einstellung in ihrem aktuellen Benutzerbereich überschrieben haben. (Das Profil wird installiert und dem geräteweiten System zugeordnet, falls dies noch nicht der Fall ist.)

Nein

Aktueller Benutzer

Profil vom Typ ICC oder CDMP

Das Profil wird standardmäßig für den jeweiligen Typ mit dem Gerät verwendet, unabhängig von der systemweiten Standardeinstellung für den aktuellen Benutzer. (Das Profil wird installiert und dem Gerät für den aktuellen Benutzer zugeordnet, falls dies noch nicht der Fall ist.)

Ja, wenn das Profil bereits installiert ist

${ROWSPAN2}$Set Profil für einen Typ (ICC, DMP, CAMP, GMMP) und Untertypkombination als globaler Standardwert${REMOVE}$

Systemweit

Nur ICC- und CDMP-Profile können Geräten zugeordnet werden.

Das Profil wird standardmäßig für den jeweiligen Typ verwendet. Benutzer können diese Einstellung im aktuellen Benutzerbereich überschreiben. (Das Profil wird installiert, wenn dies nicht bereits der Fall ist.)

Nein

Aktueller Benutzer

Nur ICC- und CDMP-Profile können Geräten zugeordnet werden.

Das Profil wird standardmäßig für den jeweiligen Typ für den aktuellen Benutzer verwendet. (Das Profil wird installiert, wenn dies nicht bereits der Fall ist.)

Ja, wenn das Profil bereits installiert ist.

${ROWSPAN2}$Erase die aktuelle Benutzerüberschreibung für eine bestimmte Standardprofileinstellung, sodass der Systemstandard immer (als Fallback) auch für den aktuellen Benutzerbereich verwendet wird.${REMOVE}$

Systemweit

Nicht zutreffend

Aktueller Benutzer

Auch bei aktuellen Benutzerabfragen in Standardprofileinstellungen werden systemweite Einstellungen zur Verwendung zurückgegeben.

Ja

${ROWSPAN2}$Enumerate installierte Profile, die bestimmte Kriterien erfüllen (z. B. Geräteklasse, Profilklasse usw.)${REMOVE}$

Systemweit

Nur ICC- und CDMP-Profile können für Geräte zugeordnet und aufgezählt werden.

Profile, die installiert sind und die angegebenen Kriterien im systemweiten Bereich erfüllen, werden aufgezählt.

Ja

Aktueller Benutzer

Nur ICC- und CDMP-Profile können geräten zugeordnet und somit für Geräte aufgezählt werden.

Profile, die installiert sind und die angegebenen Kriterien im systemweiten Bereich erfüllen, werden aufgezählt.

Ja

${ROWSPAN2}$Enumerate Profile, die einem bestimmten Gerät zugeordnet sind, das bestimmte Kriterien erfüllt, z. B. Geräteklasse und Profilklasse${REMOVE}$

Systemweit

Nur ICC- und CDMP-Profile können für Geräte zugeordnet und aufgezählt werden.

Profile, die dem Gerät im systemweiten Bereich zugeordnet sind und die angegebenen Kriterien im systemweiten Bereich erfüllen, werden aufgezählt.

Ja

Aktueller Benutzer

Nur ICC- und CDMP-Profile können für Geräte zugeordnet und aufgezählt werden.

Profile, die dem Gerät im aktuellen Benutzerbereich zugeordnet sind, einschließlich der systemweiten Zuordnungen und erfüllen die angegebenen Kriterien im aktuellen Benutzerbereich werden aufgezählt.

Ja

 

Die gültigen Farbprofiltypen werden von der COLORPROFILETYPE-Aufzählung bereitgestellt.

Die gültigen Farbprofiluntertypen werden von der COLORPROFILESUBTYPE-Aufzählung bereitgestellt.

Die gültigen Profiltyp-/Untertypkombinationen werden in der folgenden Tabelle angezeigt.

COLORPROFILETYPE

Gültige COLORPROFILESUBTYPE

Notizen

Gerätestandard

Globaler Standardwert

Beabsichtigte Verwendung

Beabsichtigte Verwendung

CPT_ICC

CPST_NONE

Abrufen/Festlegen des Standard-ICC-Profils, das einem Gerät zugeordnet ist

CPST_RGBWorkingSpace oder CPST_CustomWorkingSpace

Get/Set ICC profile as global RGB or custom working space profile. Siehe Hinweis.

Die COLORPROFILETYPE-CPT_ICC und CPT_DMP schließen sich gegenseitig aus. Das Standardfarbprofil, das Sie für einen bestimmten Arbeitsbereich (RGB oder Benutzerdefiniert) festlegen, kann entweder ein ICC-Profil oder ein DMP-Profil sein, aber nicht beides.

CPT_DMP

CPST_NONE

Abrufen/Festlegen des standardmäßigen DMP-Profils, das einem Gerät zugeordnet ist

CPST_RGBWorkingSpace oder CPST_CustomWorkingSpace

Abrufen/Festlegen des DMP-Profils als globales RGB- oder benutzerdefiniertes Arbeitsraumprofil. Siehe Hinweis.

Die COLORPROFILETYPE-CPT_ICC und CPT_DMP schließen sich gegenseitig aus. Das Standardfarbprofil, das Sie für einen bestimmten Arbeitsbereich (RGB oder Benutzerdefiniert) festlegen, kann entweder ein ICC-Profil oder ein DMP-Profil sein, aber nicht beides.

 

 

Die Architektur wird gemäß den Anforderungen der Vorgänge entworfen, wie in den Enumerationen und Tabellen oben erwähnt.

Öffentliche API-Ebene der Profilverwaltung

Da der Profilverwaltungsbereich von älteren ICM2-APIs nicht unterstützt wird, ist eine neue Gruppe von WCS-Profilverwaltungs-APIs erforderlich, die den Profilverwaltungsbereich als systemweiter oder aktueller Benutzer definiert. ? Legacy-ICM2-APIs werden weiterhin aus Gründen der Abwärtskompatibilität unterstützt und arbeiten an profilverwaltungsbereich, die für den Aufruf implizit sind. o ICM2-APIs, die im aktuellen Benutzerbereich funktionieren? Dies gilt für Vorgänge, die sowohl für systemweite als auch für den aktuellen Benutzerbereich in der WCS-Profilverwaltung unterstützt werden. Ältere ICM2-APIs rufen neue WCS-APIs mit Profilverwaltungsbereich als aktueller Benutzer auf. Dies ist aus Benutzerperspektive sinnvoll, da dies benutzerspezifische Einstellungen aus älteren Anwendungen ermöglicht und auch die meisten Vorgänge im LUA-Kontext ausführt. o ICM2-APIs, die auf systemweitem Umfang funktionieren? Dies gilt für Vorgänge (Installationsprofile und Deinstallationsprofile), die nur systemweiten Umfang unterstützen. Es werden keine neuen WCS-Profilverwaltungs-APIs erstellt, und vorhandene APIs können geändert werden.

Die zugrunde liegenden Implementierungen der Profilverwaltungsvorgänge arbeiten an den folgenden Konfigurationsdatenentitäten, um den Kontext für Farbverarbeitungsalgorithmen zu erstellen, um Farbverwaltungsfunktionen bereitzustellen. Sie sind gerätespezifische oder globale Einstellungen (geräteunabhängig). o Gerätespezifische Konfigurationsdaten: ? Liste der Profile, die einem bestimmten Gerät zugeordnet sind. ? Standardprofil für verschiedene Profiltypen, die einem Gerät zugeordnet sind. ? Abgleichsmodus von Profilen, die für die Aufzählung verwendet werden. o Globale Konfigurationsdaten: ? Liste der im System installierten Profile. ? Globales Standardprofil für verschiedene Profiltypen. ? Die zugrunde liegenden Implementierungen der Konfigurationsdatenspeicherung übernehmen den Speicherumfang für Konfigurationsdaten (entweder geräteunabhängig oder gerätespezifisch), die entweder systemweit oder aktuell verwendet werden können. Dies unterscheidet sich vom Profilverwaltungsbereich. Ein Vorgang mit Dem aktuellen Benutzerprofilverwaltungsbereich kann zu einem Lesevorgang aus einem systemweiten Speicherbereich führen, wenn die aktuelle Benutzereinstellung für diesen Vorgang nicht vorhanden ist. ? Die ICM2/WCS-API-Layeraufrufe in dieser Speicherebene zum Abrufen und Festlegen von Daten mit dem entsprechenden Speicherbereich. Die Speicherebene ist für den Profilverwaltungsbereich transparent. Die Logik zum Kombinieren von Daten aus aktuellen Benutzer- und systemweiten Speicherbereichen zum Erstellen oder Aktualisieren einer Konfiguration gemäß dem vom API-Aufrufer angegebenen Profilverwaltungsbereich. Diese Logik ist auf der ICM2/WCS-API-Ebene vorhanden.

Gerätespezifische Speicherebene

Der Speicher für verschiedene Geräteklassen wie Drucken, Erfassen oder Anzeigen kann sich voneinander unterscheiden. Beispielsweise müssen Konfigurationsdaten für ein Druckgerät mithilfe standardmäßiger Druck-APIs wie SetPrinterDataEx und GetPrinterDataEx gespeichert werden, damit die Profile während der Point-and-Print-Verbindung auf einen Clientcomputer übertragen werden können. ? Diese Ebene exportiert Funktionen zum öffnenden Speicher, Abrufen von Daten, Festlegen von Daten und Schließen des Speichers mithilfe gängiger vordefinierter Schnittstellen, damit die Profilverwaltungskonfigurationsspeicherebene sie aufrufen kann, während sie transparent sind, wie die Daten für dieses Gerät gespeichert werden.

Das folgende Diagramm veranschaulicht diese Architektur.

Öffentliche API-Ebene der Profilverwaltung

${ROWSPAN2}$Legacy ICM2-APIs für Vorgänge, die nur den systemweiten Profilverwaltungsbereich in Vista unterstützen (Installieren, Deinstallieren und Abrufen des Farbverzeichnisses). Sie rufen die Konfigurationsspeicherebene mit dem entsprechenden Speicherbereich auf.${REMOVE}$

Legacy-ICM2-API für Vorgänge, die den systemweiten und aktuellen Benutzerprofilverwaltungsbereich in Vista unterstützen (alle Vorgänge außer Installation, Deinstallation und Abrufen des Farbverzeichnisses). Sie arbeiten implizit am aktuellen Benutzerbereich und rufen die neue WCS-API mit Profilverwaltungsbereich als aktueller Benutzer auf.

Neue WCS-API mit systemweiter und aktueller Unterstützung des Benutzerprofilverwaltungsbereichs. Sie rufen die Konfigurationsspeicherebene mit dem entsprechenden Speicherbereich auf.

 

Profilverwaltungskonfigurationsspeicherebene

Geräteunabhängige globale Konfigurationsroutinen

Gerätespezifische Konfigurationsroutinen

${ROWSPAN3}$Profile- und geräteunabhängige Standardprofileinstellungenverwaltung, die im systemweiten und aktuellen Speicherbereich unterstützt wird.${REMOVE}$

Gerätezuordnung und gerätespezifische Standardprofileinstellungenverwaltung, die im systemweiten und aktuellen Speicherbereich unterstützt werden.

Device-Specific Speicherebene

Drucken bestimmter Speicher

Anzeigen bestimmter Speicher

Erfassen bestimmter Speicher

 

Ältere ICM2-APIs für Vorgänge, die nur systemweite Profilverwaltungsbereiche in Vista unterstützen, haben keine Verhaltensänderungen. Installations- und Deinstallationsvorgänge fallen in diese Kategorie.

Ältere ICM2-APIs für Vorgänge, die sowohl systemweite als auch aktuelle Benutzerprofilverwaltungsbereiche unterstützen, haben ihr Verhalten geändert, um aktuelle Benutzereinstellungen abzufragen und zu konfigurieren. Alle Vorgänge außer Der Installations- und Deinstallationsvorgang fallen in diese Kategorie.