Funzione DrvQueryColorProfile (winddiui.h)

  • Articolo

La funzione DrvQueryColorProfile consente a una DLL dell'interfaccia della stampante di specificare un profilo ICC da usare per la gestione dei colori.

Sintassi

BOOL DrvQueryColorProfile(
        HANDLE    hPrinter,
  [in]  PDEVMODEW pdevmode,
        ULONG     ulQueryMode,
  [out] VOID      *pvProfileData,
  [out] ULONG     *pcbProfileData,
  [out] FLONG     *pflProfileData
);

Parametri

hPrinter

Handle stampante fornito dal chiamante.

[in] pdevmode

Puntatore fornito dal chiamante a una struttura DEVMODEW .

ulQueryMode

Uno dei flag di bit forniti dal chiamante seguente, che indica il tipo di profilo da specificare.

Flag Definizione
QCP_DEVICEPROFILE Il chiamante richiede un profilo del dispositivo.
QCP_SOURCEPROFILE Il chiamante richiede un profilo di origine.

[out] pvProfileData

Puntatore fornito dal chiamante a un buffer per ricevere informazioni sul profilo.

[out] pcbProfileData

Puntatore fornito dal chiamante a un valore che rappresenta le dimensioni, in byte, del buffer a cui punta pvProfileData.

[out] pflProfileData

Uno dei flag di bit forniti dalla funzione seguenti, che indica il tipo di informazioni restituite dalla funzione.

Flag Definizione
QCP_PROFILEDISK La funzione restituisce il nome file di un profilo ICC nel buffer a cui punta pvProfileData.
QCP_PROFILEMEMORY La funzione restituisce i dati del profilo nel buffer a cui punta pvProfileData.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE; in caso contrario, restituisce FALSE.

Commenti

Una DLL dell'interfaccia della stampante può facoltativamente fornire una funzione DrvQueryColorProfile . Se la funzione viene specificata, GDI lo chiama se ICM è stato abilitato per un processo di stampa. Lo scopo della funzione è determinare e specificare un profilo CPI appropriato per l'uso con il processo di stampa.

Se la DLL dell'interfaccia della stampante di un driver non fornisce una funzione DrvQueryColorProfile o se la funzione restituisce FALSE, GDI tenta di trovare un profilo. Per altre informazioni, vedere Individuazione dei profili ICC.

Se le dimensioni del buffer di output specificate da pcbProfileData sono troppo piccole, il driver deve sovrascrivere il valore di dimensione fornito da pcbProfileData con le dimensioni del buffer necessarie, chiamare SetLastError(ERROR_INSUFFICIENT_BUFFER) e restituire FALSE.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winddiui.h (include Winddiui.h)