Метод ISensorDriver::OnClientSubscribeToEvents (sensorsclassextension.h)

Метод ISensorDriver::OnClientSubscribeToEvents уведомляет драйвер датчика о том, что авторизованное клиентское приложение запрашивает уведомления о событиях.

Синтаксис

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Параметры

pClientFile

Указатель на интерфейс IWDFFile, представляющий объект файла для приложения, запрашивающего уведомления о событиях.

pwszSensorID

LPWSTR, содержащий идентификатор датчика, с которого клиентское приложение запрашивает уведомления о событиях.

Возвращаемое значение

Если операция выполнена успешно, этот метод возвращает S_OK. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Комментарии

Когда клиентское приложение запрашивает уведомления о событиях, драйвер вызывает все события в расширение класса датчика для указанного идентификатора объекта. Затем расширение класса пересылает эти события в API датчика в качестве уведомлений о событиях для приложений.

Вы можете поддерживать количество ссылок на подключенные приложения для каждого датчика, чтобы избежать обратных вызовов событий, когда это не требуется.

События, определяемые платформой, определяются в sensors.h.

Дополнительные сведения об использовании этого метода см. в разделе Фильтрация данных.

Требования

Требование Значение
Целевая платформа Windows
Header sensorsclassextension.h
Библиотека SensorsClassExtension.lib

См. также раздел

ISensorDriver