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

Artigo
02/07/2025

O método IPrintOemUI::QueryColorProfile 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 de OEMUIOBJ.

pPublicDM

Ponteiro fornecido pelo chamador para uma estrutura de 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.

Bandeira	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 seguintes sinalizadores de bits fornecidos pelo método, indicando o tipo de informação que o método está retornando.

Bandeira	Definição
QCP_PROFILEDISK	O método está retornando o nome do 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.

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemUI::QueryColorProfile de um plug-in de interface do 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 método IPrintOemUI::QueryColorProfile. A função DrvQueryColorProfile executa seu próprio processamento para o evento especificado e, em seguida, chama o método IPrintOemUI::QueryColorProfile para lidar com o processamento adicional do evento.

Se IPrintOemUI::QueryColorProfile 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 os drivers de impressora da Microsoft.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Compartilhar via