IPrintOemUni::ResetPDEV method (prcomoem.h)

The IPrintOemUni::ResetPDEV method allows a rendering plug-in for Unidrv to reset its PDEV structure.

Syntax

HRESULT ResetPDEV(
  PDEVOBJ pdevobjOld,
  PDEVOBJ pdevobjNew
);

Parameters

pdevobjOld

Caller-supplied pointer to a DEVOBJ structure containing current PDEV information.

pdevobjNew

Caller-supplied pointer to a DEVOBJ structure into which the method should place new PDEV information.

Return value

The method must return one of the following values.

Return code Description
S_OK
The operation succeeded.
E_FAIL
The operation failed.
 

If the operation fails, this method should call SetLastError.

Remarks

A rendering plug-in for Unidrv must implement the IPrintOemUni::ResetPDEV method.

A rendering plug-in's IPrintOemUni::ResetPDEV method performs the same types of operations as the DrvResetPDEV function that is exported by a printer graphics DLL. During the processing of an application's call to the Microsoft Windows SDK ResetDC function, the IPrintOemUni::ResetPDEV method is called by the DrvResetPDEV function in Unidrv's printer graphics DLL. For more information about when DrvResetPDEV is called, see its description.

The rendering plug-in's private PDEV structure's address is contained in the pdevOEM member of the DEVOBJ structure pointed to by pdevobjOld. The IPrintOemUni::ResetPDEV method should use relevant members of this old structure to fill in the new structure, which is referenced through pdevobjNew.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)

See also

DrvResetPDEV

IPrintOemUni