Metodo IWiaDevMgr::RegisterEventCallbackInterface (wia_xp.h)

Articolo
03/03/2024

Il metodo IWiaDevMgr::RegisterEventCallbackInterface registra una notifica dell'evento Windows Image Acquisition (WIA) in esecuzione.

Sintassi

HRESULT RegisterEventCallbackInterface(
  [in]  LONG              lFlags,
  [in]  BSTR              bstrDeviceID,
  [in]  const GUID        *pEventGUID,
  [in]  IWiaEventCallback *pIWiaEventCallback,
  [out] IUnknown          **pEventObject
);

Parametri

[in] lFlags

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

[in] bstrDeviceID

Tipo: BSTR

Specifica un identificatore di dispositivo. Passare NULL per registrare l'evento in tutti i dispositivi WIA.

[in] pEventGUID

Tipo: GUID const*

Specifica l'evento per il quale l'applicazione sta registrando. Per un elenco di eventi standard, vedere Identificatori eventi WIA.

[in] pIWiaEventCallback

Tipo: IWiaEventCallback*

Puntatore all'interfaccia IWiaEventCallback usata dal sistema WIA per inviare la notifica dell'evento.

[out] pEventObject

Tipo: IUnknown**

Riceve l'indirizzo di un puntatore all'interfaccia IUnknown .

Valore restituito

Tipo: HRESULT

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

Commenti

Avviso L'uso dei metodi IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface e DeviceManager.RegisterEvent dello stesso processo dopo il riavvio del servizio Immagine continua può causare una violazione di accesso, se le funzioni sono state usate prima dell'arresto del servizio.

Quando iniziano a eseguire, le applicazioni WIA usano questo metodo per registrare per ricevere eventi del dispositivo hardware del tipo WIA_NOTIFICATION_EVENT. Ciò impedisce il riavvio dell'applicazione quando si verifica un altro evento per il quale viene registrato. Dopo che un programma richiama IWiaDevMgr::RegisterEventCallbackInterface per registrarsi per ricevere eventi WIA da un dispositivo, gli eventi registrati vengono indirizzati al programma dal sistema WIA.

Le applicazioni usano il metodo EnumRegisterEventInfo per recuperare un puntatore a un oggetto enumeratore per le proprietà di registrazione eventi.

Un'applicazione può trovare se un evento è un tipo di azione o un tipo di notifica (o entrambi) esaminando il valore ulFlags di una struttura WIA_DEV_CAP restituita dall'enumerazione evento.

Le applicazioni possono annullare la registrazione per gli eventi usando il puntatore IUnknown restituito tramite il parametro pEventObject per chiamare il metodo IUnknown::Release .

Nota In un'applicazione multi thread non è garantito che il callback della notifica evento venga inserito nello stesso thread che ha registrato il callback.

Requisiti

Requisito	Valore
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
DLL	Wiaservc.dll

Condividi tramite