Méthode IStillImageW ::EnableHwNotifications (sti.h)
La méthode IStillImage ::EnableHwNotifications demande au moniteur d’événements d’image toujours d’activer ou de désactiver la notification des applications lorsque événements d’appareil Still Image se produisent pour un appareil spécifié.
Syntaxe
HRESULT EnableHwNotifications(
[in] LPCWSTR pwszDeviceName,
BOOL bNewState
);
Paramètres
[in] pwszDeviceName
Pointeur fourni par l’appelant vers une chaîne représentant un nom d’appareil interne, obtenu en appelant IStillImage ::GetSTILaunchInformation ou IStillImage ::GetDeviceList.
bNewState
Valeur fournie par l’appelant, définie sur TRUE pour activer les notifications et FAUX pour les désactiver.
Valeur de retour
Si l’opération réussit, la méthode retourne S_OK. Sinon, elle retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.
Remarques
La méthode IStillImage ::EnableHwNotifications active ou désactive les notifications d’événements d’appareil toujours image pour toutes les applications, pas seulement pour l’application appelante. Les notifications d’événements sont activées par défaut. Cette méthode est destinée à être utilisée par les applications qui interceptent les événements à partir d’appareils et les redirigent à nouveau.
Avant d’appeler IStillImage ::EnableHwNotifications, les clients de l’interface IStillImage COM doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | sti.h (include Sti.h) |