Метод ISensorDriver::OnClientSubscribeToEvents (sensorclassextension.h)
Метод ISensorDriver::OnClientSubscribeToEvents уведомляет драйвер датчика о том, что авторизованное клиентское приложение запрашивает уведомления о событиях.
Синтаксис
HRESULT OnClientSubscribeToEvents(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
Параметры
pClientFile
Указатель на интерфейс IWDFFile, представляющий объект файла для приложения, запрашивающего уведомления о событиях.
pwszSensorID
LPWSTR, содержащий идентификатор датчика, из которого клиентское приложение запрашивает уведомления о событиях.
Возвращаемое значение
Если операция выполнена успешно, этот метод возвращает S_OK. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Замечания
Когда клиентское приложение запрашивает уведомления о событиях, драйвер вызывает все события в расширение класса датчика для указанного идентификатора объекта. Затем расширение класса пересылает эти события в API датчика в виде уведомлений о событиях для приложений.
Можно поддерживать количество ссылок подключенных приложений для каждого датчика, чтобы избежать обратного вызова событий, если это не требуется.
События, определяемые платформой, определяются в sensor.h.
Дополнительные сведения об использовании этого метода см. в разделе Фильтрация данных.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | sensorclassextension.h |
| библиотеки | SensorClassExtension.lib |