Metodo IStiDevice::GetLastNotificationData (sti.h)

Il metodo IStiDevice::GetLastNotificationData restituisce una descrizione dell'evento più recente che si è verificato in un dispositivo ancora immagine.

Sintassi

HRESULT GetLastNotificationData(
  [out] LPSTINOTIFY lpNotify
);

Parametri

[out] lpNotify

Puntatore fornito dal chiamante a una struttura STINOTIFY per ricevere informazioni sugli eventi.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Osservazioni

Ogni volta che si verifica un eventi del dispositivo ancora immagine, il monitoraggio eventi immagine continua chiama IStiUSD::GetNotificationData (esportato da un minidriver fornito dal fornitore) per ottenere una descrizione dell'evento. Queste descrizioni vengono aggiunte a un elenco collegato. Se un client dell'interfaccia COM IStiDevice ha chiamato IStiDevice::Subscribe, riceve una notifica ogni volta che si verifica un evento del dispositivo. Può quindi chiamare IStiDevice::GetLastNotificationData per ottenere l'aggiunta più recente all'elenco collegato di eventi.

Prima di chiamare IStiDevice::GetLastNotificationData, i client dell'interfaccia IStiDevice COM devono chiamare IStillImage::CreateDevice per ottenere un puntatore di interfaccia IStiDevice, che fornisce l'accesso a un dispositivo specificato.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	sti.h (include Sti.h)