Metodo IPrintOemPS2::GetPDEVAdjustment (prcomoem.h)

Articolo
02/29/2024

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

Contrassegno	Significato
PDEV_ADJUST_PAPER_MARGIN_TYPE	Regolare l'impostazione del margine di 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 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 IPrintOemPS2::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 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.