Méthode IStillImageW ::EnableHwNotifications (sti.h)
La méthode IStillImage ::EnableHwNotifications demande au moniteur d’événements d’image fixe d’activer ou de désactiver la notification des applications lorsque des événements d’appareil d’image fixe 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, obtenue en appelant IStillImage ::GetSTILaunchInformation ou IStillImage ::GetDeviceList.
bNewState
Valeur fournie par l’appelant, définie sur TRUE pour activer les notifications et FALSE pour les désactiver.
Valeur retournée
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 d’image fixe 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 aux applications qui interceptent les événements des appareils et les redirigent.
Avant d’appeler IStillImage ::EnableHwNotifications, les clients de l’interface COM IStillImage doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | sti.h (inclure Sti.h) |