IStiDevice::GetLastNotificationData method (sti.h)

The IStiDevice::GetLastNotificationData method returns a description of the most recent event that occurred on a still image device.

Syntax

HRESULT GetLastNotificationData(
  [out] LPSTINOTIFY lpNotify
);

Parameters

[out] lpNotify

Caller-supplied pointer to an STINOTIFY structure to receive event information.

Return value

If the operation succeeds, the method returns S_OK. Otherwise, it returns one of the STIERR-prefixed error codes defined in stierr.h.

Remarks

Each time a Still Image Device Events occurs, the still image event monitor calls IStiUSD::GetNotificationData (exported by a vendor-supplied minidriver) to obtain an event description. These descriptions are added to a linked list. If a client of the IStiDevice COM interface has called IStiDevice::Subscribe, it is notified each time a device event occurs. It can then call IStiDevice::GetLastNotificationData to obtain the most recent addition to the linked list of events.

Before calling IStiDevice::GetLastNotificationData, clients of the IStiDevice COM interface must call IStillImage::CreateDevice to obtain an IStiDevice interface pointer, which provides access to a specified device.

Requirements