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

  • Artigo

O IPrintOemUIMXDC::AdjustImageableArea método permite que um driver de pipeline de filtro XPS use UnidrvUI.dll ou PS5UI.dll para dar suporte à configuração da área imprimível, incluindo orientação e direção de rotação.

Sintaxe

HRESULT AdjustImageableArea(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PRECTL         prclImageableArea
);

Parâmetros

hPrinter

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

cbDevMode

O tamanho da estrutura DEVMODE , em bytes, 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.

prclImageableArea

Um ponteiro para uma estrutura RECTL que contém a área imprimível. Esse parâmetro é preenchido por UnidrvUI.dll ou PS5UI.dll com dados do GPD ou PPD correspondente, antes que o parâmetro seja passado para o plug-in. Em seguida, o plug-in pode atualizar esses dados antes de retornar.

Retornar valor

AdjustImageableArea retornará S_OK se esse 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 prclImageableArea é IN OUT. Todos os outros parâmetros para esse método são somente entrada.

Se o plug-in não puder concluir a operação, ele deverá retornar um valor HRESULT de falha apropriado, o que fará 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)

Confira também

IPrintOemUIMXDC

RECTL