Método IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)
El IPrintOemUIMXDC::AdjustImageableArea método permite que un controlador de canalización de filtro XPS use UnidrvUI.dll o PS5UI.dll para admitir la configuración del área imprimible, incluida la orientación y la dirección de rotación.
Sintaxis
HRESULT AdjustImageableArea(
HANDLE hPrinter,
DWORD cbDevMode,
const PDEVMODE pDevMode,
DWORD cbOEMDM,
const PVOID pOEMDM,
PRECTL prclImageableArea
);
Parámetros
hPrinter
Identificador de la impresora que se está consultando actualmente.
cbDevMode
Tamaño de la estructura DEVMODE , en bytes, incluidos los datos anexados.
pDevMode
Puntero a la estructura DEVMODE que contiene la configuración actual del dispositivo.
cbOEMDM
Número de bytes de la sección proporcionada por el proveedor de la estructura DEVMODE.
pOEMDM
Puntero a los datos contenidos en la parte del proveedor de la estructura DEVMODE a la que apunta pDevMode .
prclImageableArea
Puntero a una estructura RECTL que contiene el área imprimible. Este parámetro se rellena mediante UnidrvUI.dll o PS5UI.dll con datos del GPD o PPD correspondiente, antes de pasar el parámetro al complemento. Después, el complemento puede actualizar estos datos antes de devolverlos.
Valor devuelto
AdjustImageableArea devuelve S_OK si este método se realiza correctamente. De lo contrario, este método debe devolver E_NOTIMPL si el complemento no admite el método o cualquier valor de error adecuado si el complemento no puede completar la operación. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Comentarios
El parámetro prclImageableArea es IN OUT. Todos los demás parámetros de este método son solo de entrada.
Si el complemento no puede completar la operación, debe devolver un valor HRESULT de error adecuado, lo que hará que se produzca un error en el trabajo de impresión actual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible con Windows Vista y versiones posteriores de Unidrvui.dll y Ps5ui.dll, que son redistribuibles. Este método también está disponible para los controladores XPSDrv en Microsoft Windows XP si ha instalado XPS Essentials Pack. |
| Plataforma de destino | Escritorio |
| Encabezado | prcomoem.h (incluya Prcomoem.h) |