Funzione wiasQueueEvent (wiamdef.h)
La funzione wiasQueueEvent informa il servizio che il dispositivo ha generato un evento.
Sintassi
HRESULT wiasQueueEvent(
[in] BSTR bstrDeviceId,
[in] const GUID *pEventGUID,
[in, optional] BSTR bstrFullItemName
);
Parametri
[in] bstrDeviceId
Specifica l'ID dispositivo. Questo è il valore passato al minidriver nella chiamata al metodo IWiaMiniDrv::d rvInitializeWia.
[in] pEventGUID
Puntatore a un buffer contenente il GUID per l'evento.
[in, optional] bstrFullItemName
Specifica il nome completo dell'elemento, incluse le informazioni sul percorso.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore wia .
Osservazioni
Questo metodo deve essere usato ogni volta che il dispositivo deve segnalare che si è verificato un evento di un tipo. Il dispositivo esegue questa operazione posizionando l'evento nella coda di eventi. Ad esempio, quando una fotocamera acquisisce una nuova immagine, deve generare un evento WIA_EVENT_ITEM_CREATED dopo l'aggiunta di un nuovo elemento driver alla relativa struttura ad albero. La fotocamera può inserire questo evento nella coda di eventi in questo modo:
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
Per un elenco completo degli identificatori di evento WIA, vedere la documentazione di Windows SDK.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamdef.h (include Wiamdef.h) |
| libreria | Wiaservc.lib |
| dll | Wiaservc.dll |