Método IPrintOemUIMXDC::AdjustImageCompression (prcomoem.h)

O IPrintOemUIMXDC::AdjustImageCompression método permite que um driver de pipeline de filtro XPS use UnidrvUI.dll ou PS5UI.dll para dar suporte à configuração do nível de compactação para imagens JPEG ou PNG.

Sintaxe

HRESULT AdjustImageCompression(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PLONG          pCompressionMode
);

Parâmetros

hPrinter

Um identificador para a impressora que está sendo consultada no momento.

cbDevMode

O tamanho da estrutura DEVMODE , incluindo dados acrescentados.

pDevMode

Um ponteiro para a estrutura DEVMODE que contém as configurações atuais do dispositivo.

cbOEMDM

O número de bytes na seção fornecida pelo fornecedor da estrutura DEVMODE.

pOEMDM

Um ponteiro para os dados contidos na parte do fornecedor da estrutura DEVMODE para a qual pDevMode aponta.

pCompressionMode

Um ponteiro para o nível de compactação atual. pCompressionMode é um tipo de enumeração especificado em Mxdc.h.

Retornar valor

AdjustImageCompression retornará S_OK se o método for bem-sucedido. Caso contrário, esse método deverá retornar E_NOTIMPL se o plug-in não der suporte ao método ou qualquer valor de falha apropriado se o plug-in não puder concluir a operação. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

O IPrintOemUIMXDC::AdjustImageCompression método afeta imagens JPEG e PNG geradas pelo MXDC (Conversor de Documentos XPS da Microsoft). O IPrintOemUIMXDC::AdjustImageCompression método não afeta as imagens JPEG e PNG que são enviadas diretamente por aplicativos para gDI por meio do mecanismo de passagem de imagem JPEG/PNG GDI (BMF_JPEG, BMF_PNG).

Os principais drivers, UnidrvUI.dll e PS5UI.dll, não modificam as configurações de compactação de imagem. No entanto, o plug-in pode alterar o valor que é inicialmente fornecido ao MXDC pelo caminho de impressão GDI.

O parâmetro pCompressionMode tem um dos seguintes valores predefinidos.

Tipo de ENUM	Valor	Significado
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Menor qualidade e menor tamanho de arquivo
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Qualidade média e tamanho médio do arquivo
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Tamanho de arquivo grande e de alta qualidade
MXDC_IMAGETYPE_PNG	4	Maior qualidade e maior tamanho de arquivo

 

O parâmetro pCompressionMode é IN OUT. Todos os outros parâmetros para essa função são somente entrada.

Se o plug-in não puder concluir a operação, ele deverá retornar uma falha apropriada HRESULT, o que faz com que o trabalho de impressão atual falhe.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível com o Windows Vista e versões posteriores de Unidrvui.dll e Ps5ui.dll, que são redistribuíveis. Esse método também estará disponível para drivers XPSDrv no Microsoft Windows XP se você tiver instalado o XPS Essentials Pack.
Plataforma de Destino	Área de Trabalho
Cabeçalho	prcomoem.h (inclua Prcomoem.h)