WcsSetDefaultColorProfile-Funktion (icm.h)

Artikel
08/24/2023

Legt den Standardfarbprofilnamen für den angegebenen Profiltyp im angegebenen Profilverwaltungsbereich fest.

Hinweis

Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileSetDisplayDefaultAssociation zum Verwalten erweiterter Farbprofile.

Syntax

BOOL WcsSetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  LPCWSTR                      pProfileName
);

Parameter

scope

Ein WCS_PROFILE_MANAGEMENT_SCOPE Wert, der den Bereich dieses Profilverwaltungsvorgangs angibt.

pDeviceName

Ein Zeiger auf den Namen des Geräts, für das das Standardfarbprofil festgelegt werden soll. Bei NULL wird ein geräteunabhängiges Standardprofil verwendet.

cptColorProfileType

Ein COLORPROFILETYPE-Wert , der den Farbprofiltyp angibt.

cpstColorProfileSubType

Ein COLORPROFILESUBTYPE-Wert , der den Farbprofiluntertyp angibt.

dwProfileID

Die ID des Farbraums, den das Farbprofil darstellt. Dies ist ein benutzerdefinierter ID-Wert, der zum eindeutigen Identifizieren des Farbraumprofils in Ihrer Anwendung verwendet wird.

pProfileName

Ein Zeiger auf einen Puffer, der den Namen des Farbprofils enthält. Siehe Hinweise.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

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

Hinweise

Wenn der pProfileName-ParameterNULL und der parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, geben nachfolgende Aufrufe von WcsSetDefaultColorProfile das systemweite Standardprofil zurück.

Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, ist diese Funktion in Least-Privileged LUA-Kontext (User Account) ausführbar. Andernfalls sind Administratorrechte erforderlich. Das angegebene Profil muss bereits installiert sein, aber es ist möglicherweise noch nicht dem angegebenen Gerät im angegebenen Profilverwaltungsbereich zugeordnet.

Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, funktioniert diese Funktion nicht ordnungsgemäß, wenn sie aus dem Systemkontext und nicht aus einem Benutzerkonto gestartet wird.

Wenn WcsSetDefaultColorProfile aufgerufen wird, um ein Gerätemodellprofil DMP als Standardprofil für den RGB- oder benutzerdefinierten Arbeitsbereich festzulegen, ist nur ein DMP-Profil vom Typ RGBVirtualDevice, LCD oder CRT gültig. alle anderen sind ungültig.

Wenn WcsSetDefaultColorProfile aufgerufen wird, um ein ICC-Profil (International Color Consortium) als Standardprofil für den RGB- oder benutzerdefinierten Arbeitsbereich festzulegen, ist nur ein ICC-Profil mit der Klasse "spac" oder "disp" und der Farbraum "RGB" gültig; alle anderen sind ungültig.

Weitere Informationen finden Sie unter Hinweise zu gültigen Profiltyp-/Untertypkombinationen.

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

Freigeben über