Метод IStillImageW::EnableHwNotifications (sti.h)
Метод IStillImage::EnableHwNotifications запрашивает монитор событий неподвижного изображения, чтобы включить или отключить уведомление приложений при возникновении событий устройства Still Image для указанного устройства.
Синтаксис
HRESULT EnableHwNotifications(
[in] LPCWSTR pwszDeviceName,
BOOL bNewState
);
Параметры
[in] pwszDeviceName
Предоставленный вызывающим элементом указатель на строку, представляющую имя внутреннего устройства, полученное путем вызова IStillImage::GetSTILaunchInformation или IStillImage::GetDeviceList.
bNewState
Значение, предоставленное вызывающим, установите значение TRUE , чтобы включить уведомления, и FALSE , чтобы отключить их.
Возвращаемое значение
Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.
Комментарии
Метод IStillImage::EnableHwNotifications включает или отключает уведомления о событиях устройства с неподвижным изображением для всех приложений, а не только для вызывающего приложения. Уведомления о событиях включены по умолчанию. Этот метод предназначен для использования приложениями, которые перехватывают события с устройств и перенаправляет их.
Перед вызовом IStillImage::EnableHwNotifications клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | sti.h (включая Sti.h) |