Metodo IPrintOemPS2::GetPDEVAdjustment (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemPS2::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. Sono attualmente supportati i flag seguenti:

Bandiera	Significato
PDEV_ADJUST_PAPER_MARGIN_TYPE	Regolare l'impostazione del margine della carta segnalata nel PDEV. Vedere la struttura PDEV_ADJUST_PAPER_MARGIN.
PDEV_HOSTFONT_ENABLED_TYPE	Abilitare o disabilitare la funzionalità di supporto hostfont. Vedere la struttura PDEV_HOSTFONT_ENABLED.
PDEV_USE_TRUE_COLOR_TYPE	Abilitare o disabilitare l'output dei colori per stampanti monocromatica e colori. Vedere la struttura PDEV_USE_TRUE_COLOR.

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 IPrintOemPS2::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 XP e versioni successive.

Attualmente, il driver Pscript5 chiama IPrintOemPS2::GetPDEVAdjustment per regolare l'impostazione del margine di carta, come indicato in PDEV, per abilitare o disabilitare la funzionalità Hostfont o per attivare o disattivare l'output del colore PostScript.