Метод 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 |