Метод IStiDevice::Subscribe (sti.h)
Метод IStiDevice::Subscribe регистрирует вызывающий объект для получения уведомлений о событиях устройства.
Синтаксис
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
Параметры
[in, out] lpSubsribe
Предоставленный вызывающим элементом указатель на структуру STISUBSCRIBE , содержащую значения параметров подписки.
Возвращаемое значение
Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.
Комментарии
Метод IStiDevice::Subscribe обычно вызывается приложениями, которые перехватывают события с устройств и перенаправляет их. Метод позволяет этим приложениям получать уведомления о событиях устройства с неподвижным изображением , чтобы затем они могли отправлять управление в соответствующие приложения для отображения.
На основе содержимого, предоставленного в структуре STISUBSCRIBE , вызывающий объект может запрашивать уведомления о событиях устройства сообщениями Windows или событиями Win32 (с помощью вызовов SetEvent ).
Когда приложение получает уведомление о событии, оно может вызвать IStiDevice::GetLastNotificationData , чтобы узнать, какое событие произошло.
Перед вызовом IStiDevice::Subscribe клиенты COM-интерфейса IStiDevice должны вызвать IStillImage::CreateDevice , чтобы получить указатель интерфейса IStiDevice , который предоставляет доступ к указанному устройству.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | sti.h (включая Sti.h) |