Condividi tramite

Funzione GetStandardColorSpaceProfileA (icm.h)

  • Articolo

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

Sintassi

BOOL GetStandardColorSpaceProfileA(
  PCSTR  pMachineName,
  DWORD  dwSCS,
  PSTR   pBuffer,
  PDWORD pcbSize
);

Parametri

pMachineName

Riservato. Deve essere NULL. Questo parametro è destinato a 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 colore 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 posizionate in pdwSize.

pcbSize

Puntatore a una variabile contenente le dimensioni in byte del buffer a cui fa riferimento 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 sull'errore estese, 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 puntata da pdwSize conterrà il numero di byte necessari per il buffer a puntato da 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 Windows Color System (WCS) oltre ai profili International Color Consortium (ICC). Non supporta i profili WCS CAMP o GMMP e restituirà un errore se tali profili vengono usati.

Panoramica delle funzionalità specifiche di Windows Vista

In questo modo verranno supportati i dmp WCS oltre ai profili ICC. 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 di colore registrato per lo spazio colore standard specificato per l'utente corrente. Se non esiste alcuna impostazione per l'utente corrente, recupera l'impostazione a livello di sistema.

Questo usa WcsGetDefaultColorProfile con WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Questo è 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