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 |
|---|---|
|
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 |
|
| MIDL |
|