Funzione WcsGetDefaultColorProfile (icm.h)

  • Articolo

Recupera il profilo di colore predefinito per un dispositivo o per un valore predefinito indipendente dal dispositivo se il dispositivo non è specificato.

Nota

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

Sintassi

BOOL WcsGetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  DWORD                        cbProfileName,
  LPWSTR                       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 viene ottenuto il profilo di colore predefinito. Se NULL, viene ottenuto un profilo predefinito indipendente dal dispositivo.

cptColorProfileType

Valore COLORPROFILETYPE che specifica il tipo di profilo colore.

cpstColorProfileSubType

Valore COLORPROFILESUBTYPE che specifica il sottotipo del profilo di colore.

dwProfileID

ID dello spazio dei colori rappresentato dal profilo di colore.

cbProfileName

Dimensioni del buffer, in byte, del buffer a cui fa riferimento pProfileName.

pProfileName

Puntatore a un buffer per ricevere il nome del profilo di colore. Le dimensioni del buffer, in byte, saranno indicate da cbProfileName.

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

Usare la funzione WcsGetDefaultColorProfileSize per ottenere le dimensioni necessarie del buffer a cui punta il parametro pProfileName .

Se WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER è presente, esegue l'override del valore predefinito a livello di sistema per profileManagementScope.

Questa funzione è eseguibile nel contesto Least-Privileged account utente (LUA).

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