Método IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)
O método IPrintOemUIMXDC::AdjustImageableArea 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 de 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 que 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.
Valor de retorno
AdjustImageableArea retorna 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.
Observações
O parâmetro prclImageableArea é IN OUT. Todos os outros parâmetros para esse método são somente de 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 |
|---|---|
| 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) |