IPrintOemPS2::GetPDEVAdjustment method (prcomoem.h)

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

Syntax

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

Parameters

pdevobj

Pointer to a DEVOBJ structure.

dwAdjustType

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

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.

cbBuffer

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

[out] pbAdjustmentDone

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.

Return value

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.

Requirements

See also

IPrintOemPS2

PDEV_ADJUST_PAPER_MARGIN

PDEV_HOSTFONT_ENABLED

PDEV_USE_TRUE_COLOR