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 retournée

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 type quelconque s’est produit. Pour ce faire, l’appareil place l’événement dans la file d’attente des événements. Par exemple, lorsqu’un appareil photo prend une nouvelle image, il doit générer un événement WIA_EVENT_ITEM_CREATED après avoir ajouté un nouvel élément de pilote à son arborescence. La caméra peut placer cet événement dans la file d’attente d’événements de cette façon :

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

Consultez la documentation SDK Windows pour obtenir la liste complète des identificateurs d’événements WIA.

Configuration requise

Voir aussi

IWiaMiniDrv ::d rvInitializeWia