Método IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)
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) |