Funzione DrvIcmCreateColorTransform (winddi.h)

La funzione DrvIcmCreateColorTransform crea una trasformazione del colore ICM.

Sintassi

HANDLE DrvIcmCreateColorTransform(
  [in]           DHPDEV           dhpdev,
  [in]           LPLOGCOLORSPACEW pLogColorSpace,
  [in, optional] PVOID            pvSourceProfile,
  [in]           ULONG            cjSourceProfile,
  [in]           PVOID            pvDestProfile,
  [in]           ULONG            cjDestProfile,
  [in, optional] PVOID            pvTargetProfile,
  [in]           ULONG            cjTargetProfile,
  [in]           DWORD            dwReserved
);

Parametri

[in] dhpdev

Gestire il PDEV del dispositivo fisico.

[in] pLogColorSpace

Puntatore a una struttura dello spazio dei colori logico. La struttura LOGCOLORSPACEW è definita nella documentazione di Microsoft Windows SDK. Il driver deve ottenere informazioni sullo spazio dei colori di origine da questa struttura quando pvSourceProfile è NULL.

[in, optional] pvSourceProfile

Puntatore alla mappa di memoria del profilo di origine. Questo parametro può essere NULL.

[in] cjSourceProfile

Specifica le dimensioni, in byte, della mappa di memoria del profilo di origine. Se pvSourceProfile è NULL, questo parametro deve essere impostato su zero.

[in] pvDestProfile

Puntatore alla mappa di memoria del profilo di destinazione.

[in] cjDestProfile

Specifica le dimensioni, in byte, della mappa di memoria del profilo di destinazione.

[in, optional] pvTargetProfile

Puntatore alla mappa di memoria del profilo di destinazione. Questo parametro può essere NULL.

[in] cjTargetProfile

Specifica le dimensioni, in byte, della mappa di memoria del profilo di destinazione. Se pvTargetProfile è NULL, questo parametro deve essere impostato su zero.

[in] dwReserved

Parametro riservato che deve essere impostato su zero.

Valore restituito

DrvIcmCreateColorTransform restituisce un handle alla trasformazione creata al termine dell'operazione. In caso contrario, segnala un errore e restituisce NULL.

Commenti

Il driver crea una trasformazione del colore dai dati del profilo come indicato di seguito:

• Il driver deve usare il profilo di origine a cui pvSourceProfile punta quando non è NULL. In caso contrario, il driver deve usare i dati nella struttura a cui pLogColorSpace punta per le informazioni sullo spazio dei colori di origine.
• Quando il driver riceve un profilo di destinazione, ma nessun profilo di destinazione, deve archiviare i dati necessari per trasformare i colori dallo spazio colore di origine specificato nello spazio colore di destinazione specificato.
• Quando il driver riceve profili di destinazione e di destinazione, i dati devono archiviare i dati necessari per trasformare i colori dallo spazio colore di origine specificato nello spazio colore di destinazione e dallo spazio colore di destinazione allo spazio colore di destinazione. In questo scenario il dispositivo del driver è il dispositivo di destinazione in cui è possibile verificare un'immagine. Il driver deve quindi essere in grado di convertire lo spazio colore dell'immagine di correzione nello spazio colore del dispositivo di destinazione.

Indipendentemente dal fatto che sia specificato un profilo di destinazione, il dispositivo del driver è sempre il dispositivo di destinazione.

I profili forniti rispettano la versione 2.10 del formato del profilo ICC. Se il driver non riconosce il formato specificato, deve non riuscire la chiamata.

Il driver può accedere in modo sicuro all'intera mappa di memoria di ogni profilo. I puntatori pvSourceProfile, pvDestProfile e pvTargetProfile sono validi solo durante l'ambito della chiamata a DrvIcmCreateTransform.

I driver che segnalano il supporto di ICM devono implementare questa funzione. Un driver indica il supporto per ICM impostando il flag GCAPS_ICM nel membro flGraphicsCaps della struttura DEVINFO .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche

DrvIcmDeleteColorTransform