IWiaMiniDrv::drvNotifyPnpEvent method (wiamindr_lh.h)

Article
02/22/2024

The IWiaMiniDrv::drvNotifyPnpEvent method responds to the event received from the WIA service.

Syntax

HRESULT drvNotifyPnpEvent(
  [in] const GUID *pEventGUID,
  [in] BSTR       bstrDeviceID,
  [in] ULONG      ulReserved
);

Parameters

[in] pEventGUID

Points to a GUID identifying the event.

[in] bstrDeviceID

Specifies a string containing the device's unique identifier.

[in] ulReserved

Reserved.

Return value

On success, the method should return S_OK. If the method fails, it should return a standard COM error code.

Remarks

The WIA service notifies a WIA minidriver of a supported device event by calling the IWiaMiniDrv::drvNotifyPnpEvent method. In this method the minidriver implements the device-specific functionality needed to respond to the event.

If this method is called with *pEventGuid set to WIA_EVENT_CANCEL_IO device event, it should cancel all current I/O operations as soon as possible.

Requirements

Requirement	Value
Target Platform	Desktop
Header	wiamindr_lh.h (include Wiamindr.h)