Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|---|---|
|
The operation succeeded. |
|
The operation failed. |
|
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) |