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

O IPrintOemUIMXDC::AdjustDPI método permite que um driver de pipeline de filtro XPS use UnidrvUI.dll ou PS5UI.dll para dar suporte à configuração de resolução de imagem.

Sintaxe

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

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.

pDPI

Um ponteiro para a resolução atual, em pontos por polegada (DPI), supondo pixels quadrados. Se esse parâmetro estiver configurado, seu valor retornado deverá ser um inteiro positivo.

Retornar valor

AdjustDPI 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 parâmetro pDPI é 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 do 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)