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.
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) |