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

Artigo
02/07/2025

O método IPrintOemUIMXDC::AdjustImageCompression 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 de 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 que pDevMode aponta.

pCompressionMode

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

Valor de retorno

AdjustImageCompression retorna 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.

Observações

O método IPrintOemUIMXDC::AdjustImageCompression afeta imagens JPEG e PNG geradas pelo MXDC (Conversor de Documentos do Microsoft XPS). O método IPrintOemUIMXDC::AdjustImageCompression 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 GDI JPEG/PNG (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 fornecido inicialmente para o 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	Alta qualidade e tamanho de arquivo grande
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 de 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
de cliente com suporte mínimo	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.
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Partilhar via