Méthode IStiUSD ::SetNotificationHandle (stiusd.h)

La méthode IStiUSD ::SetNotificationHandle d’un minidriver d’image fixe spécifie un handle d’événement que le minidriver doit utiliser pour informer l’appelant des événements d’appareil.

Syntaxe

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Paramètres

hEvent

Handle fourni par l’appelant à un événement Win32, créé en appelant CreateEvent.

Valeur retournée

Si l’opération réussit, la méthode doit retourner S_OK. Sinon, elle doit retourner l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Si le pilote (et le périphérique) prend en charge la notification asynchrone des événements de périphérique d’image fixe, la méthode IStiUSD ::SetNotificationHandle du minidriver est le moyen par lequel le moniteur d’événements demande au pilote de le notifier lorsqu’un événement se produit.

Si hEvent est un handle d’événement, la méthode IStiUSD ::SetNotificationHandle doit stocker le handle et l’utiliser comme argument d’entrée dans SetEvent (décrit dans la documentation Microsoft Windows SDK). Le pilote doit appeler SetEvent chaque fois qu’un événement d’appareil est détecté, pour informer le moniteur d’événements qu’un événement s’est produit.

Si hEvent a la valeur NULL, la méthode doit désactiver la notification des événements d’appareil.

Configuration requise