Partager via

Méthode IWiaEventCallback::ImageEventCallback (wia_xp.h)

  • Article

La méthode IWiaEventCallback::ImageEventCallback est appelée par le système d’exécution WiA (Windows Image Acquisition) lorsqu’un événement d’appareil matériel se produit.

Syntaxe

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

Paramètres

[in] pEventGUID

Type : GUID const*

Spécifie l’identificateur unique de l’événement. Pour obtenir la liste complète des événements d’appareil, consultez Identificateurs d’événements WIA.

[in] bstrEventDescription

Type : BSTR

Spécifie la description de chaîne de l’événement.

[in] bstrDeviceID

Type : BSTR

Spécifie l’identificateur unique de l’appareil WIA.

[in] bstrDeviceDescription

Type : BSTR

Spécifie la description de chaîne de l’appareil.

[in] dwDeviceType

Type : DWORD

Spécifie le type de périphérique. Pour obtenir la liste des valeurs possibles , consultez Spécificateurs de type d’appareil WIA.

[in] bstrFullItemName

Type : BSTR

Spécifie le nom complet de l’élément WIA qui représente l’appareil.

[in, out] pulEventType

Type : ULONG*

Pointeur vers un ULONG qui spécifie si un événement est un événement de notification, un événement d’action ou les deux. La valeur 1 indique un événement de notification, la valeur 2 indique un événement d’action et la valeur 3 indique que l’événement est de type notification et action.

[in] ulReserved

Type : ULONG

Réservé aux informations utilisateur.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour recevoir une notification des événements d’appareil matériel WIA, les applications passent un pointeur vers l’interface IWiaEventCallback vers la méthode RegisterEventCallbackInterface . Le système d’exécution WIA utilise ensuite ce pointeur d’interface pour appeler la méthode IWiaEventCallback::ImageEventCallback chaque fois qu’un événement d’appareil matériel WIA se produit.

Notez que rien ne garantit que le rappel sera appelé sur le thread qui a inscrit l’interface IWiaEventCallback .

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wia_xp.h (inclure Wia.h)
Bibliothèque Wiaguid.lib