IWiaDevMgr2 :: RegisterEventCallbackCLSID, méthode
La méthode IWiaDevMgr2 :: RegisterEventCallbackCLSID inscrit une application pour recevoir des événements même si l’application n’est pas en cours d’exécution.
Syntaxe
HRESULT RegisterEventCallbackCLSID(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[in] const GUID *pEventGUID,
[in, unique] const GUID *pClsID,
[in] BSTR bstrName,
[in] BSTR bstrDescription,
[in] BSTR bstrIcon
);
Paramètres
-
lFlags [ dans]
-
Type : long
Spécifie les indicateurs d’inscription. Peut être défini avec les valeurs suivantes :
Indicateur d’inscription Signification _rappel d' _ événement de Registre WIA _ Inscrivez-vous à l’événement. _rappel d’événement d’annulation d’inscription WIA _ _ Supprimez l’inscription de l’événement. _Gestionnaire WIA _ par défaut _ Définissez l’application en tant que gestionnaire d’événements par défaut. -
bstrDeviceID [ dans]
-
Type : BSTR
Spécifie un identificateur d’appareil. Transmettez la valeur null pour l’inscription de l’événement sur tous les appareils WIA 2,0.
-
pEventGUID [ dans]
-
Type : const GUID *
Spécifie l’événement pour lequel l’application est inscrite. Pour obtenir la liste des événements standard, consultez la page identificateurs d’événements WIA.
-
pClsID [ dans]
-
Type : const GUID *
Pointeur vers l’ID de classe d’application (CLSID). Le système d’exécution WIA 2,0 utilise le CLSID de l’application pour démarrer l’application quand un événement s’est produit pour lequel il est enregistré.
-
bstrName [ dans]
-
Type : BSTR
Spécifie le nom de l’application qui s’inscrit pour l’événement.
-
bstrDescription [ dans]
-
Type : BSTR
Spécifie une description textuelle de l’application qui s’inscrit pour l’événement.
-
bstrIcon [ dans]
-
Type : BSTR
Spécifie le nom d’un fichier image à utiliser pour l’icône de l’application qui s’inscrit pour l’événement.
Valeur de retour
Type : HRESULT
Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .
Notes
Les applications WIA 2,0 utilisent cette méthode pour s’inscrire afin de recevoir des événements de périphérique matériel. Après l’appel de IWiaDevMgr2 :: RegisterEventCallbackCLSID , l’application est inscrite pour recevoir des événements d’appareil WIA 2,0, même s’il n’est pas en cours d’exécution.
Lorsque l’événement se produit, le système WIA 2,0 détermine quelle application est inscrite pour recevoir l’événement. Elle utilise la fonction CoCreateInstance et le CLSID spécifiés dans le paramètre pClsID pour créer une instance de l’application, puis appelle la méthode ImageEventCallback pour transmettre les informations d’événement à l’application.
Une application peut appeler la méthode EnumRegisterEventInfo pour énumérer les informations d’inscription des événements.
Si l’application n’est pas un composant COM (Component Object Model) inscrit et n’est pas compatible avec l’architecture WIA 2,0, utilisez la méthode IWiaDevMgr2 :: RegisterEventCallbackProgram pour inscrire une application pour les événements d’appareil.
Notes
Dans une application multithread, il n’y a aucune garantie que le rappel de notification d’événement soit retourné sur le thread 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 |
|