Compartilhar via


Função DrvQueryColorProfile (winddiui.h)

A função DrvQueryColorProfile permite que uma DLL de interface de impressora especifique um perfil ICC a ser usado para gerenciamento de cores.

Sintaxe

BOOL DrvQueryColorProfile(
        HANDLE    hPrinter,
  [in]  PDEVMODEW pdevmode,
        ULONG     ulQueryMode,
  [out] VOID      *pvProfileData,
  [out] ULONG     *pcbProfileData,
  [out] FLONG     *pflProfileData
);

Parâmetros

hPrinter

Identificador de impressora fornecido pelo chamador.

[in] pdevmode

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW .

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.

[out] pvProfileData

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

[out] pcbProfileData

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

[out] pflProfileData

Um dos seguintes sinalizadores de bits fornecidos pela função, indicando o tipo de informação que a função está retornando.

Sinalizador Definição
QCP_PROFILEDISK A função está retornando o nome do arquivo de um perfil ICC no buffer apontado por pvProfileData.
QCP_PROFILEMEMORY A função está retornando dados de perfil no buffer apontado por pvProfileData.

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE; caso contrário, retornará FALSE.

Comentários

Opcionalmente, uma DLL de interface de impressora pode fornecer uma função DrvQueryColorProfile . Se a função for fornecida, a GDI a chamará se o ICM tiver sido habilitado para um trabalho de impressão. A finalidade da função é determinar e especificar um perfil ICC apropriado para uso com o trabalho de impressão.

Se a DLL da interface da impressora de um driver não fornecer uma função DrvQueryColorProfile ou se a função retornar FALSE, a GDI tentará encontrar um perfil. Para obter mais informações, consulte Localizando perfis ICC.

Se o tamanho do buffer de saída especificado por pcbProfileData for muito pequeno, o driver deverá substituir o valor de tamanho fornecido por pcbProfileData com o tamanho do buffer necessário, chamar SetLastError(ERROR_INSUFFICIENT_BUFFER) e retornar FALSE.

Requisitos

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