Metodo IWiaEventCallback::ImageEventCallback (wia_xp.h)

Il metodo IWiaEventCallback::ImageEventCallback viene richiamato dal sistema di runtime di Acquisizione immagini di Windows (WIA) quando si verifica un evento del dispositivo hardware.

Sintassi

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

Parametri

[in] pEventGUID

Tipo: GUID const*

Specifica l'identificatore univoco dell'evento. Per un elenco completo degli eventi del dispositivo, vedere Identificatori eventi WIA.

[in] bstrEventDescription

Tipo: BSTR

Specifica la descrizione della stringa dell'evento.

[in] bstrDeviceID

Tipo: BSTR

Specifica l'identificatore univoco del dispositivo WIA.

[in] bstrDeviceDescription

Tipo: BSTR

Specifica la descrizione della stringa del dispositivo.

[in] dwDeviceType

Tipo: DWORD

Specifica il tipo di dispositivo. Per un elenco di valori possibili, vedere Identificatori di tipo di dispositivo WIA .

[in] bstrFullItemName

Tipo: BSTR

Specifica il nome completo dell'elemento WIA che rappresenta il dispositivo.

[in, out] pulEventType

Tipo: ULONG*

Puntatore a un ULONG che specifica se un evento è un evento di notifica, un evento di azione o entrambi. Un valore pari a 1 indica un evento di notifica, un valore pari a 2 indica un evento di azione e un valore pari a 3 indica che l'evento è sia di tipo di notifica che di azione.

[in] ulReserved

Tipo: ULONG

Riservato per le informazioni utente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per ricevere una notifica degli eventi del dispositivo hardware WIA, le applicazioni passano un puntatore all'interfaccia IWiaEventCallback al metodo RegisterEventCallbackInterface . Il sistema di runtime WIA usa quindi il puntatore dell'interfaccia per richiamare il metodo IWiaEventCallback::ImageEventCallback ogni volta che si verifica un evento del dispositivo hardware WIA.

Si noti che non esiste alcuna garanzia che il callback verrà richiamato nello stesso thread che ha registrato l'interfaccia IWiaEventCallback .

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wia_xp.h (includere Wia.h)
Libreria	Wiaguid.lib