Metodo IPrintOemUni3::GetPDEVAdjustment (prcomoem.h)

Articolo
08/07/2023

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

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.

Contrassegno	Significato
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Modificare l'impostazione di risoluzione grafica segnalata nella struttura PDEV. Per altre informazioni, vedere la struttura PDEV_ADJUST_GRAPHICS RESOLUTION .
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Modificare 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 state apportate 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 viene effettivamente modificato un valore nel buffer. Questo può essere usato dal driver per le ottimizzazioni.

Valore restituito

Il IPrintOemUni3::GetPDEVAdjustment metodo 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. Ovvero, la catena di plug-in viene chiamata fino a quando non viene trovato il primo plug-in in in in grado di gestire la regolazione.

Commenti

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 in PDEV, per regolare l'area di origine immaginebile o per regolare le dimensioni fisiche della carta.