wiasQueueEvent, fonction (wiamdef.h)
La fonction wiasQueueEvent informe le service que l’appareil a généré un événement.
Syntaxe
HRESULT wiasQueueEvent(
[in] BSTR bstrDeviceId,
[in] const GUID *pEventGUID,
[in, optional] BSTR bstrFullItemName
);
Paramètres
[in] bstrDeviceId
Spécifie l’ID de l’appareil. Il s’agit de la valeur passée au minidriver dans l’appel à la méthode IWiaMiniDrv ::d rvInitializeWia.
[in] pEventGUID
Pointeur vers une mémoire tampon qui contient le GUID de l’événement.
[in, optional] bstrFullItemName
Spécifie le nom complet de l’élément, y compris les informations de chemin d’accès.
Valeur de retour
En cas de réussite, la fonction retourne S_OK.
Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA .
Remarques
Cette méthode doit être utilisée chaque fois que l’appareil doit signaler qu’un événement d’un certain type s’est produit. L’appareil effectue cette opération en plaçant l’événement dans la file d’attente d’événements. Par exemple, lorsqu’une caméra prend une nouvelle image, elle doit générer un événement WIA_EVENT_ITEM_CREATED après l’ajout d’un nouvel élément de pilote à son arborescence. L’appareil photo peut placer cet événement dans la file d’attente des événements de cette façon :
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
Consultez la documentation du Kit de développement logiciel (SDK) Windows pour obtenir la liste complète des identificateurs d’événements WIA.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamdef.h (include Wiamdef.h) |
| bibliothèque | Wiaservc.lib |
| DLL | Wiaservc.dll |