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
WIA. h