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

El IPrintOemUI::QueryColorProfile método 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 suministrado por el autor de la llamada.

poemuiobj

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

pPublicDM

Puntero proporcionado por el autor de la llamada a una estructura 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.

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.

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 siguientes marcas de bits proporcionadas por el método, que indica el tipo de información que devuelve el método.

Marca	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 está implementado.

Comentarios

Un método del complemento de interfaz de IPrintOemUI::QueryColorProfile 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 DrvQueryColorProfile .

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

Si IPrintOemUI::QueryColorProfile varios complementos de interfaz de usuario exportan 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	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)