IWiaDevMgr2 :: RegisterEventCallbackInterface, méthode

inscrit une application en cours d’exécution pour la notification d’événement 2,0 de l’Acquisition d’images (WIA) de Windows.

Syntaxe

HRESULT RegisterEventCallbackInterface(
  [in]        LONG              lFlags,
  [in]        BSTR              bstrDeviceID,
  [in]  const GUID              *pEventGUID,
  [in]        IWiaEventCallback *pIWiaEventCallback,
  [out]       IUnknown          **pEventObject
);

Paramètres

lFlags [ dans]

Type : long

Actuellement inutilisé. Doit être défini sur zéro (0).

bstrDeviceID [ dans]

Type : BSTR

Spécifie l’identificateur unique d’un appareil WIA 2,0. Affectez la valeur null à ce paramètre pour vous inscrire à l’événement sur tous les appareils WIA 2,0.

pEventGUID [ dans]

Type : const GUID *

Spécifie un pointeur vers l’identificateur d’événement pour lequel l’application est inscrite. Consultez identificateurs d’événements WIA pour les identificateurs d’événements standard.

pIWiaEventCallback [ dans]

Type : IWiaEventCallback*

Spécifie un pointeur vers l’interface IWiaEventCallback que l’WIA 2,0 utilise pour envoyer une notification d’événement.

pEventObject [ à]

Type : IUnknown**

Reçoit l’adresse d’un pointeur vers l’interface IUnknown .

Valeur de retour

Type : HRESULT

Retourne les codes d’erreur COM standard ou les éléments suivants.

Code de retour Description
_NOTIMPL E
L’interface IUnknown ne peut pas être retournée.

Notes

Avertissement

L’utilisation des méthodes IWiaDevMgr :: RegisterEventCallbackInterface, IWiaDevMgr2 :: RegisterEventCallbackInterface et devicemanager. RegisterEvent à partir du même processus après le redémarrage du service image continue peut entraîner une violation d’accès, si les fonctions ont été utilisées avant l’arrêt du service.

Lorsque les applications WIA 2,0 commencent à s’exécuter, elles utilisent cette méthode pour s’inscrire afin de recevoir des événements de périphérique matériel. Cela empêche l’application d’être redémarrée lorsqu’un autre événement pour lequel elle est inscrite se produit. Une fois qu’une application appelle IWiaDevMgr2 :: RegisterEventCallbackInterface pour s’inscrire pour recevoir les événements WIA 2,0 d’un appareil, les événements inscrits sont acheminés vers le programme par WIA 2,0.

Les applications doivent appeler la méthode IUnknown :: Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre pEventObject .

Notes

Dans une application multithread, le rappel de notification d’événements peut se trouver sur un thread différent de celui qui a inscrit le rappel.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
WIA. h
MIDL
WIA. idl