IStiUSD ::SetNotificationHandle, méthode (stiusd.h)

La méthode IStiUSD ::SetNotificationHandle d’un minidriver d’image 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 pour un événement Win32, créé en appelant CreateEvent.

Valeur de retour

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

Remarques

Si le pilote (et l’appareil) prend en charge la notification asynchrone de événements d’appareil Still Image, la méthode iStiUSD ::SetNotificationHandle est le moyen par lequel le moniteur d’événements demande au pilote de l’avertir 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 pour SetEvent (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows). Le pilote doit appeler SetEvent chaque fois qu’un événement d’appareil est détecté, pour avertir le moniteur d’événement qu’un événement s’est produit.

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	stiusd.h (include Stiusd.h)