Metodo IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)

  • Articolo

Il IPrintOemUIMXDC::AdjustImageableArea metodo consente a un driver della pipeline di filtro XPS di usare UnidrvUI.dll o PS5UI.dll per supportare la configurazione dell'area stampabile, incluso 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 in esecuzione una query.

cbDevMode

Dimensioni della struttura DEVMODE , in byte, inclusi i dati aggiunti.

pDevMode

Puntatore alla struttura DEVMODE contenente 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 dati provenienti dall'oggetto 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 questo 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 può completare l'operazione. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

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, che eseguirà l'esito negativo del processo di stampa corrente.

Requisiti

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)

Vedi anche

IPrintOemUIMXDC

RECTL