Edit

IPrintOemUI::DriverEvent method (prcomoem.h)

  • Article

The printer driver's DrvDriverEvent function calls a user interface plug-in's IPrintOemUI::DriverEvent method for additional processing of printer driver events.

Syntax

HRESULT DriverEvent(
  DWORD  dwDriverEvent,
  DWORD  dwLevel,
  LPBYTE pDriverInfo,
  LPARAM lParam
);

Parameters

dwDriverEvent

Caller-supplied bit flag indicating the event that has occurred. Valid flags are listed in the following table.

Flag Definition
DRIVER_EVENT_DELETE The driver is being removed.
DRIVER_EVENT_INITIALIZE The driver has just been installed.

dwLevel

Caller-supplied value indicating the type of structure pointed to by the pDriverInfo parameter, as indicated in the following table.

dwLevel Value Structure pointed to by pDriverInfo
1 DRIVER_INFO_1
2 DRIVER_INFO_2
3 DRIVER_INFO_3
 

The DRIVER_INFO_N structures are described in the Microsoft Windows SDK documentation.

pDriverInfo

Caller-supplied pointer to a structure whose type is identified by the dwLevel parameter.

lParam

Caller-supplied flags. See the following Remarks section.

Return value

The method must return one of the following values.

Return code Description
S_OK
 The operation succeeded.
E_FAIL
 The operation failed.
E_NOTIMPL
 The method is not implemented.

Remarks

A user interface plug-in's IPrintOemUI::DriverEvent method performs the same types of operations as the DrvDriverEvent function that is exported by user-mode printer interface DLLs. For information about driver events and how they should be processed, see the description of the DrvDriverEvent function.

If you provide a user interface plug-in, the printer driver's DrvDriverEvent function calls the IPrintOemUI::DriverEvent method. The DrvDriverEvent function performs its own processing for the specified event, and then calls the IPrintOemUI::DriverEvent method to handle additional processing of the event.

If IPrintOemUI::DriverEvent methods are exported by multiple user interface plug-ins, the methods are called in the order that the plug-ins are specified for installation.

For more information about creating and installing user interface plug-ins, see Customizing Microsoft's Printer Drivers.

Requirements

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

See also

DrvDriverEvent

IPrintOemUI