Метод 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клиенты интерфейса IStiDevice COM должны вызывать IStillImage::CreateDevice, чтобы получить указатель интерфейса IStiDevice, который предоставляет доступ к указанному устройству.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | sti.h (include Sti.h) |