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

O IPrintOemUI::QueryColorProfile método permite que um plug-in de interface do usuário especifique um perfil ICC a ser usado para gerenciamento de cores.

Sintaxe

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

Parâmetros

hPrinter

Identificador de impressora fornecido pelo chamador.

poemuiobj

Ponteiro fornecido pelo chamador para uma estrutura OEMUIOBJ .

pPublicDM

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW validada.

pOEMDM

Ponteiro fornecido pelo chamador para os membros da estrutura DEVMODEW privada do plug-in de interface do usuário.

ulQueryMode

Um dos seguintes sinalizadores de bits fornecidos pelo chamador, indicando o tipo de perfil a ser especificado.

Sinalizador	Definição
QCP_DEVICEPROFILE	O chamador está solicitando um perfil de dispositivo.
QCP_SOURCEPROFILE	O chamador está solicitando um perfil de origem.

pvProfileData

Ponteiro fornecido pelo chamador para um buffer para receber informações de perfil.

pcbProfileData

Ponteiro fornecido pelo chamador para um valor que representa o tamanho, em bytes, do buffer apontado por pvProfileData.

pflProfileData

Um dos sinalizadores de bit fornecidos pelo método a seguir, indicando o tipo de informação que o método está retornando.

Sinalizador	Definição
QCP_PROFILEDISK	O método está retornando o nome de arquivo de um perfil ICC no buffer apontado por pvProfileData.
QCP_PROFILEMEMORY	O método está retornando dados de perfil no buffer apontado por pvProfileData.

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi realizada com êxito.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não está implementado.

Comentários

O método de um plug-in de interface do IPrintOemUI::QueryColorProfile usuário executa os mesmos tipos de operações que a função DrvQueryColorProfile exportada por DLLs de interface da impressora no modo de usuário. Para obter informações sobre eventos de impressora e como eles devem ser processados, consulte a descrição da função DrvQueryColorProfile .

Se você fornecer um plug-in de interface do usuário, a função DrvQueryColorProfile do driver de impressora chamará o IPrintOemUI::QueryColorProfile método . A função DrvQueryColorProfile executa seu próprio processamento para o evento especificado e, em seguida, chama o IPrintOemUI::QueryColorProfile método para manipular o processamento adicional do evento.

Se IPrintOemUI::QueryColorProfile os métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando drivers de impressora da Microsoft.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	prcomoem.h (inclua Prcomoem.h)