Método IPrintOemUI::QueryColorProfile (prcomoem.h)

El método IPrintOemUI::QueryColorProfile permite que un complemento de interfaz de usuario especifique un perfil ICC que se usará para la administración de colores.

Sintaxis

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

Parámetros

hPrinter

Controlador de impresora proporcionado por el autor de la llamada.

poemuiobj

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

pPublicDM

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

pOEMDM

Puntero proporcionado por el autor de la llamada a los miembros privados de la estructura DEVMODEW del complemento de interfaz de usuario.

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.

pvProfileData

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

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.

pflProfileData

Una de las marcas de bits proporcionadas por el método siguiente, que indica el tipo de información que devuelve el método.

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

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

Un método IPrintOemUI::QueryColorProfile del complemento de interfaz de usuario realiza los mismos tipos de operaciones que la función DrvQueryColorProfile que exporta los archivos DLL de la interfaz de impresora en modo de usuario. Para obtener información sobre los eventos de impresora y cómo se deben procesar, consulte la descripción de la función de DrvQueryColorProfile.

Si proporciona un complemento de interfaz de usuario, el controlador de impresora drvQueryColorProfile función llama al método IPrintOemUI::QueryColorProfile. La función drvQueryColorProfile realiza su propio procesamiento para el evento especificado y, a continuación, llama al método IPrintOemUI::QueryColorProfile para controlar el procesamiento adicional del evento.

Si varios complementos de interfaz de usuario exportan IPrintOemUI::QueryColorProfile métodos, se llama a los métodos en el orden en que se especifican los complementos para la instalación.

Para obtener más información sobre cómo crear e instalar complementos de interfaz de usuario, vea Personalización de los controladores de impresora de Microsoft.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)