Función DrvQueryColorProfile (winddiui.h)

La función drvQueryColorProfile permite que un archivo DLL de interfaz de impresora especifique un perfil ICC que se usará para la administración de colores.

Sintaxis

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

Parámetros

hPrinter

Controlador de impresora proporcionado por el autor de la llamada.

[in] pdevmode

Puntero proporcionado por el autor de la llamada a una estructuraDEVMODEW.

ulQueryMode

Una de las siguientes marcas de bits proporcionadas por el autor de la llamada, que indica el tipo de perfil que se va a especificar.

Bandera	Definición
QCP_DEVICEPROFILE	El autor de la llamada solicita un perfil de dispositivo.
QCP_SOURCEPROFILE	El autor de la llamada solicita un perfil de origen.

[out] pvProfileData

Puntero proporcionado por el autor de la llamada a un búfer para recibir información de perfil.

[out] pcbProfileData

Puntero proporcionado por el autor de la llamada a un valor que representa el tamaño, en bytes, del búfer al que apunta pvProfileData.

[out] pflProfileData

Una de las siguientes marcas de bits proporcionadas por la función, que indica el tipo de información que devuelve la función.

Bandera	Definición
QCP_PROFILEDISK	La función devuelve el nombre de archivo de un perfil ICC en el búfer al que apunta pvProfileData.
QCP_PROFILEMEMORY	La función devuelve datos de perfil en el búfer al que apunta pvProfileData.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE; de lo contrario, devuelve FALSE.

Observaciones

Un dll de interfaz de impresora puede proporcionar opcionalmente una función DrvQueryColorProfile. Si se proporciona la función, GDI lo llama si ICM se ha habilitado para un trabajo de impresión. El propósito de la función es determinar y especificar un perfil ICC adecuado para su uso con el trabajo de impresión.

Si el archivo DLL de la interfaz de impresora de un controlador no proporciona un función drvQueryColorProfile o si la función devuelve FALSE, GDI intenta encontrar un perfil. Para obtener más información, vea buscar perfiles icc.

Si el tamaño del búfer de salida especificado por pcbProfileData es demasiado pequeño, el controlador debe sobrescribir el valor de tamaño proporcionado por pcbProfileData con el tamaño de búfer necesario, llame a SetLastError(ERROR_INSUFFICIENT_BUFFER) y devuelva FALSE.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	winddiui.h (incluya Winddiui.h)