Condividi tramite

Funzione GetStandardColorSpaceProfileW (icm.h)

  • Articolo

Recupera il profilo colore registrato per lo spazio colore standard specificato.

Sintassi

BOOL GetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwSCS,
  PWSTR  pBuffer,
  PDWORD pcbSize
);

Parametri

pMachineName

Riservato. Deve essere NULL. Questo parametro deve puntare al nome del computer in cui ottenere un profilo di spazio colore standard. Un puntatore NULL indica il computer locale.

dwSCS

Specifica il valore ID dello spazio colori standard per il quale recuperare il profilo. Gli unici valori validi per questo parametro sono LCS_sRGB e LCS_WINDOWS_COLOR_SPACE.

pBuffer

Puntatore al buffer in cui deve essere inserito il nome del profilo. Se NULL, la chiamata restituirà TRUE e le dimensioni necessarie del buffer vengono inserite in pdwSize.

pcbSize

Puntatore a una variabile contenente le dimensioni in byte del buffer a cui punta pProfileName. In caso di restituzione, la variabile contiene le dimensioni del buffer effettivamente usate o necessarie.

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

Se il buffer a cui punta pProfileName deve essere allocato dinamicamente da un'applicazione, l'applicazione può chiamare la funzione GetStandardColorSpaceProfile per recuperare le dimensioni necessarie per il buffer. Se getStandardColorSpaceProfile viene chiamato con pProfileName impostato su NULL, restituirà FALSE e la DWORD a cui punta pdwSize conterrà il numero di byte necessari per il buffer a cui punta pProfileName. L'applicazione può quindi allocare il buffer e chiamare nuovamente GetStandardColorSpaceProfile con pProfileName impostato sull'indirizzo del buffer.

Questa funzione supporta i profili del modello di dispositivo WCS (Windows Color System) oltre ai profili INTERNATIONAL Color Consortium (ICC). Non supporta i profili WCS CAMP o GMMP e restituirà un errore se tali profili vengono utilizzati.

Panoramica delle funzionalità specifiche di Windows Vista

Questo supporterà i DMP WCS oltre ai profili CPI. Non supporterà i profili WCS CAMP o GMMP e restituirà un errore se tali profili vengono usati con questa API.

Supporto per utente/LUA

Verrà recuperato il profilo colore registrato per lo spazio colore standard specificato per l'utente corrente. Se non esiste tale impostazione per l'utente corrente, recupera l'impostazione a livello di sistema.

Viene usato WcsGetDefaultColorProfile con WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Questo file è eseguibile nel contesto 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