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 che contiene 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.
Commenti
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 inserendo l'evento nella coda di eventi. Ad esempio, quando una fotocamera acquisisce una nuova immagine, deve generare un evento WIA_EVENT_ITEM_CREATED dopo aver aggiunto un nuovo elemento driver al relativo albero. La fotocamera può inserire questo evento nella coda degli eventi in questo modo:
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
Per un elenco completo degli identificatori di evento WIA, vedere la documentazione Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |