Funzione WcsGetDefaultColorProfileSize (icm.h)

Restituisce le dimensioni, in byte, del nome del profilo colore predefinito (incluso il carattere di terminazione NULL ) per un dispositivo.

Nota

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

Sintassi

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

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 ottenuto il profilo colore predefinito. Se NULL, verrà usato 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 colore.

dwProfileID

ID dello spazio colori rappresentato dal profilo colore.

pcbProfileName

Puntatore a una posizione che riceve le dimensioni, in byte, del nome del percorso del profilo colore predefinito, incluso il carattere di terminazione NULL .

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError.

Commenti

Utilizzare questa funzione per restituire le dimensioni necessarie del buffer a cui punta il parametro pProfileName nella funzione WcsGetDefaultColorProfile .

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

Requisiti

Requisito Valore
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