Metodo IPrintOemUni3::GetPDEVAdjustment (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUni3::GetPDEVAdjustment consente a un plug-in di eseguire l'override di impostazioni specifiche PDEV.

Sintassi

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Parametri

pdevobj

Puntatore a una struttura DEVOBJ.

dwAdjustType

Specifica il tipo di rettifica richiesto. I flag seguenti sono attualmente supportati.

Bandiera	Significato
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Regolare l'impostazione della risoluzione grafica segnalata nella struttura PDEV. Per altre informazioni, vedere la struttura PDEV_ADJUST_GRAPHICS RESOLUTION.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Regolare l'area di origine immaginebile segnalata nella struttura PDEV. Per altre informazioni, vedere la struttura PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Regolare le dimensioni fisiche della carta segnalate nella struttura PDEV. Per altre informazioni, vedere la struttura PDEV_ADJUST_PAPER_PHYSICAL_SIZE.

pBuf

Puntatore a una struttura che contiene le impostazioni pianificate utilizzate se non sono presenti modifiche. Queste strutture sono elencate nella tabella precedente. Il plug-in può sovrascrivere le impostazioni nella struttura pertinente.

cbBuffer

Specifica le dimensioni, in byte, della struttura a cui punta pBuf.

[out] pbAdjustmentDone

Puntatore a una posizione di memoria impostata dal plug-in su TRUE quando cambia effettivamente un valore nel buffer. Questa operazione può essere usata dal driver per le ottimizzazioni.

Valore restituito

Il metodo IPrintOemUni3::GetPDEVAdjustment deve restituire S_OK se riconosce il tipo di regolazione e S_FALSE in caso contrario. Se il metodo ha esito negativo, deve restituire E_FAIL. La catena di plug-in viene chiamata fino a quando non viene restituito S_OK o un codice di errore diverso da E_NOTIMPL. Vale a dire, la catena di plug-in viene chiamata fino a quando non viene trovato il primo plug-in che è in grado di gestire la regolazione.

Osservazioni

Questa funzione è disponibile in Windows Vista e versioni successive.

Attualmente, il driver Unidrv chiama IPrintOemUni3::GetPDEVAdjustment per regolare l'impostazione di risoluzione grafica, come indicato nel PDEV, per regolare l'area di origine immaginebile o per regolare il formato della carta fisica.