Skip to content

Latest commit

 

History

History
135 lines (95 loc) · 4.34 KB

nf-prcomoem-iprintoemps2-getpdevadjustment.md

File metadata and controls

135 lines (95 loc) · 4.34 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:prcomoem.IPrintOemPS2.GetPDEVAdjustment
IPrintOemPS2::GetPDEVAdjustment (prcomoem.h)
The IPrintOemPS2::GetPDEVAdjustment method enables a plug-in to override specific PDEV settings.
print\iprintoemps2_getpdevadjustment.htm
print
04/20/2018
IPrintOemPS2::GetPDEVAdjustment
GetPDEVAdjustment, GetPDEVAdjustment method [Print Devices], GetPDEVAdjustment method [Print Devices],IPrintOemPS2 interface, IPrintOemPS2 interface [Print Devices],GetPDEVAdjustment method, IPrintOemPS2.GetPDEVAdjustment, IPrintOemPS2::GetPDEVAdjustment, prcomoem/IPrintOemPS2::GetPDEVAdjustment, print.iprintoemps2_getpdevadjustment, print_unidrv-pscript_rendering_eca8e6af-1563-4028-9d87-fd014e1e06ee.xml
prcomoem.h
Prcomoem.h
Desktop
Windows
IPrintOemPS2::GetPDEVAdjustment
prcomoem/IPrintOemPS2::GetPDEVAdjustment
APIRef
kbSyntax
COM
prcomoem.h
IPrintOemPS2::GetPDEVAdjustment

IPrintOemPS2::GetPDEVAdjustment

-description

The IPrintOemPS2::GetPDEVAdjustment method enables a plug-in to override specific PDEV settings.

-parameters

-param pdevobj

Pointer to a DEVOBJ structure.

-param dwAdjustType

Specifies the type of adjustment asked for. The following flags are currently supported:

Flag Meaning
PDEV_ADJUST_PAPER_MARGIN_TYPE Adjust the paper margin setting that is reported in the PDEV. See the PDEV_ADJUST_PAPER_MARGIN structure.
PDEV_HOSTFONT_ENABLED_TYPE Enable or disable the Hostfont support feature. See the PDEV_HOSTFONT_ENABLED structure.
PDEV_USE_TRUE_COLOR_TYPE Enable or disable color output for monochrome and color printers. See the PDEV_USE_TRUE_COLOR structure.

-param pBuf

Pointer to a structure that contains the planned settings that are used if there is no change. These structures are listed in the preceding table. The plug-in can overwrite the settings in the relevant structure.

-param cbBuffer

Specifies the size, in bytes, of the structure pointed to by pBuf.

-param pbAdjustmentDone [out]

Pointer to a memory location that the plug-in sets to TRUE when it actually changes a value in the buffer. This may be used by the driver for optimizations.

-returns

The IPrintOemPS2::GetPDEVAdjustment method should return S_OK if it recognizes the adjustment type, and S_FALSE if it does not. If the method fails, it should return E_FAIL. The chain of plug-ins is called until either S_OK or a failure code other than E_NOTIMPL is returned. That is, the chain of plug-ins is called until the first plug-in that is capable of handling the adjustment is found.

-remarks

This function is available in Windows XP and later.

Currently, the Pscript5 driver calls IPrintOemPS2::GetPDEVAdjustment to adjust the paper margin setting, as reported in the PDEV, to enable or disable the Hostfont feature, or to turn PostScript color output on or off.

-see-also

IPrintOemPS2

PDEV_ADJUST_PAPER_MARGIN

PDEV_HOSTFONT_ENABLED

PDEV_USE_TRUE_COLOR