Funzione DrvQueryColorProfile (winddiui.h)

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.

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

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