IPrintOemUni3::GetPDEVAdjustment method (prcomoem.h)
The IPrintOemUni3::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.
| Flag | Meaning |
|---|---|
| PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE | Adjust the graphics resolution setting that is reported in the PDEV structure. For more information, see the PDEV_ADJUST_GRAPHICS RESOLUTION structure. |
| PDEV_IMAGEABLE_ORIGIN_AREA_TYPE | Adjust the imageable origin area that is reported in the PDEV structure. For more information, see the PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA structure. |
| PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE | Adjust the physical paper size that is reported in the PDEV structure. For more information, see the PDEV_ADJUST_PAPER_PHYSICAL_SIZE structure. |
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 IPrintOemUni3::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 Vista and later.
Currently, the Unidrv driver calls IPrintOemUni3::GetPDEVAdjustment to adjust the graphics resolution setting, as reported in the PDEV, to adjust the imageable origin area, or to adjust the physical paper size.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | prcomoem.h (include Prcomoem.h) |
See also
PDEV_ADJUST_GRAPHICS RESOLUTION
PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA