Compartir a través de


Función DrvQueryColorProfile (winddiui.h)

La función DrvQueryColorProfile permite que una 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 suministrado por el autor de la llamada.

[in] pdevmode

Puntero proporcionado por el autor de la llamada a una estructura DEVMODEW .

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.

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

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

Comentarios

Opcionalmente, un archivo DLL de interfaz de impresora puede proporcionar 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 una función DrvQueryColorProfile o si la función devuelve FALSE, GDI intenta encontrar un perfil. Para obtener más información, consulte Localización de 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 Value
Plataforma de destino Escritorio
Encabezado winddiui.h (incluya Winddiui.h)