Metodo IPrintOemUIMXDC::AdjustDPI (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUIMXDC::AdjustDPI consente a un driver della pipeline di filtro XPS di usare UnidrvUI.dll o PS5UI.dll per supportare la configurazione della risoluzione delle immagini.

Sintassi

HRESULT AdjustDPI(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PLONG          pDPI
);

Parametri

hPrinter

Handle per la stampante attualmente sottoposta a query.

cbDevMode

Dimensioni della struttura DEVMODE, 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.

pDPI

Puntatore alla risoluzione corrente, espressa in punti per pollice (DPI), presupponendo pixel quadrati. Se questo parametro è configurato, il valore restituito deve essere un numero intero positivo.

Valore restituito

AdjustDPI 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 pDPI è IN OUT. Tutti gli altri parametri per questa funzione sono solo input.

Se il plug-in non è in grado di completare l'operazione, deve restituire un 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)

Condividi tramite