Metodo IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)
Il metodo IPrintOemUIMXDC::AdjustImageableArea consente a un driver della pipeline di filtro XPS di usare UnidrvUI.dll o PS5UI.dll per supportare la configurazione dell'area stampabile, inclusi l'orientamento e la direzione della rotazione.
Sintassi
HRESULT AdjustImageableArea(
HANDLE hPrinter,
DWORD cbDevMode,
const PDEVMODE pDevMode,
DWORD cbOEMDM,
const PVOID pOEMDM,
PRECTL prclImageableArea
);
Parametri
hPrinter
Handle per la stampante attualmente sottoposta a query.
cbDevMode
Dimensioni della struttura DEVMODE, in byte, inclusi i dati accodati.
pDevMode
Puntatore alla struttura DEVMODE che contiene le impostazioni correnti del dispositivo.
cbOEMDM
Numero di byte nella sezione fornita dal fornitore della struttura DEVMODE.
pOEMDM
Puntatore ai dati contenuti nella parte fornitore della struttura DEVMODE a cui pDevMode punta.
prclImageableArea
Puntatore a una struttura RECTL che contiene l'area stampabile. Questo parametro viene popolato da UnidrvUI.dll o PS5UI.dll con i dati del GPD o PPD corrispondente, prima che il parametro venga passato al plug-in. Il plug-in può quindi aggiornare questi dati prima di restituire.
Valore restituito
AdjustImageableArea restituisce S_OK se il metodo ha esito positivo. In caso contrario, questo metodo deve restituire E_NOTIMPL se il plug-in non supporta il metodo o un valore di errore appropriato se il plug-in non è in grado di completare l'operazione. Per altre informazioni, vedere la sezione Osservazioni seguente.
Osservazioni
Il parametro prclImageableArea è IN OUT. Tutti gli altri parametri per questo metodo sono solo input.
Se il plug-in non è in grado di completare l'operazione, deve restituire un valore HRESULT di errore appropriato, causando l'esito negativo del processo di stampa corrente.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile con Windows Vista e versioni successive di Unidrvui.dll e Ps5ui.dll, ridistribuibili. Questo metodo è disponibile anche per i driver XPSDrv in Microsoft Windows XP se è stato installato XPS Essentials Pack. |
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |