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