Funzione WcsSetDefaultColorProfile (icm.h)

  • Articolo

Imposta il nome del profilo di colore predefinito per il tipo di profilo specificato nell'ambito di gestione del profilo specificato.

Nota

Questa API non supporta i profili "colore avanzati" per i monitor HDR. Usare ColorProfileSetDisplayDefaultAssociation per la gestione di profili di colore avanzati.

Sintassi

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

Parametri

scope

Valore WCS_PROFILE_MANAGEMENT_SCOPE che specifica l'ambito di questa operazione di gestione del profilo.

pDeviceName

Puntatore al nome del dispositivo per il quale deve essere impostato il profilo di colore predefinito. Se NULL viene usato un profilo predefinito indipendente dal dispositivo.

cptColorProfileType

Valore COLORPROFILETYPE che specifica il tipo di profilo di colore.

cpstColorProfileSubType

Valore COLORPROFILESUBTYPE che specifica il sottotipo del profilo di colore.

dwProfileID

ID dello spazio dei colori rappresentato dal profilo di colore. Si tratta di un valore ID personalizzato usato per identificare in modo univoco il profilo dello spazio dei colori all'interno dell'applicazione.

pProfileName

Puntatore a un buffer che contiene il nome del profilo di colore. Vedere la sezione Osservazioni.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Se il parametro pProfileName è NULL e il parametro profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, le chiamate successive a WcsSetDefaultColorProfile restituiranno il profilo predefinito a livello di sistema.

Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, questa funzione è eseguibile nel contesto dell'account utente Least-Privileged. In caso contrario, sono necessari privilegi amministrativi. Il profilo specificato deve essere già installato, ma potrebbe non essere ancora associato al dispositivo specificato nell'ambito di gestione del profilo specificato.

Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, questa funzione non funzionerà correttamente se avviata dal contesto di sistema e non da un account utente.

Quando WcsSetDefaultColorProfile viene chiamato per impostare un profilo del modello di dispositivo DMP come profilo predefinito per lo spazio di lavoro RGB o personalizzato, solo un profilo DMP di tipo RGBVirtualDevice, LCD o CRT è valido; tutti gli altri non sono validi.

Quando WcsSetDefaultColorProfile viene chiamato per impostare un profilo International Color Consortium (ICC) come profilo predefinito per lo spazio di lavoro RGB o personalizzato, solo un profilo ICC con classe "spac" o "disp" e "RGB" è valido; tutti gli altri non sono validi.

Vedere le note sulle combinazioni di tipo di profilo/sottotipo valide.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche