IStiDevice::GetLastNotificationData-Methode (sti.h)

Die IStiDevice::GetLastNotificationData-Methode gibt eine Beschreibung des letzten Ereignisses zurück, das auf einem Standbildgerät aufgetreten ist.

Syntax

HRESULT GetLastNotificationData(
  [out] LPSTINOTIFY lpNotify
);

Parameter

[out] lpNotify

Vom Aufrufer bereitgestellter Zeiger auf eine STINOTIFY-Struktur , um Ereignisinformationen zu empfangen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Jedes Mal, wenn ein Standbildgeräteereignisse auftritt, ruft der Ereignismonitor für Standbilder IStiUSD::GetNotificationData (exportiert von einem vom Hersteller bereitgestellten Minidriver) auf, um eine Ereignisbeschreibung abzurufen. Diese Beschreibungen werden einer verknüpften Liste hinzugefügt. Wenn ein Client der IStiDevice COM-Schnittstelle IStiDevice::Subscribe aufgerufen hat, wird er jedes Mal benachrichtigt, wenn ein Geräteereignis auftritt. Anschließend kann IStiDevice::GetLastNotificationData aufgerufen werden , um die neueste Ergänzung der verknüpften Ereignisliste abzurufen.

Vor dem Aufrufen von IStiDevice::GetLastNotificationData müssen Clients der IStiDevice-COM-SchnittstelleIStillImage::CreateDevice aufrufen, um einen IStiDevice-Schnittstellenzeiger abzurufen, der Zugriff auf ein angegebenes Gerät ermöglicht.

Anforderungen