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

Метод ISensorDriver::OnClientConnect уведомляет драйвер датчика о том, что клиентское приложение подключено.

Синтаксис

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Параметры

pClientFile

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

pwszSensorID

LPWSTR, содержащий идентификатор датчика, к которому подключается клиентское приложение.

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

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

Комментарии

Расширение класса датчика вызывает этот метод только в том случае, если пользователь предоставил указанному клиентскому приложению разрешение на доступ к драйверу. Если пользователь отменит это разрешение, расширение класса немедленно вызывает ISensorDriver::OnClientDisconnect для той же пары приложение/датчик.

Расширение класса всегда вызывает этот метод перед вызовом ISensorDriver::OnSetProperties или ISensorDriver::OnGetDataFields для определенного датчика. Рекомендуется поддерживать количество ссылок на подключенные приложения, чтобы определить, когда вызовы этих трех методов возможны. Если клиентские приложения не подключены, может потребоваться изменить поведение драйвера, например, выполнив действия по сокращению энергопотребления.

Значение указателя (адрес, на который указывает), предоставленное pClientFile , можно использовать в качестве идентификатора для отслеживания подключенных приложений. Однако эти идентификаторы необходимо отслеживать отдельно для каждого датчика, а не для каждого устройства, так как расширение класса может предоставлять одно и то же значение указателя для нескольких датчиков на одном устройстве.

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

Требования

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

ISensorDriver