ISensorDriver::OnClientConnect 方法 (sensorsclassextension.h)
ISensorDriver::OnClientConnect 方法通知传感器驱动程序客户端应用程序已连接。
语法
HRESULT OnClientConnect(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
参数
pClientFile
指向 IWDFFile 接口的指针,该接口表示请求连接的应用程序的文件对象。
pwszSensorID
包含客户端应用程序连接到的传感器的 ID 的 LPWSTR。
返回值
如果操作成功,此方法将返回S_OK。 否则,此方法返回 Winerror.h 中定义的错误代码之一。
注解
仅当用户向指定的客户端应用程序授予访问驱动程序的权限时,传感器类扩展才会调用此方法。 如果用户撤销此权限,类扩展会立即为同一应用程序/传感器对调用 ISensorDriver::OnClientDisconnect 。
类扩展始终在为特定传感器调用 ISensorDriver::OnSetProperties 或 ISensorDriver::OnGetDataFields 之前调用此方法。 建议维护连接的应用程序的引用计数,以帮助预测何时可以调用这三种方法。 如果没有连接客户端应用程序,则可能需要更改驱动程序的行为,例如,通过采取措施来降低功耗。
可以使用指针值 (pClientFile 提供的指向) 的地址作为一种 ID 来跟踪连接的应用程序。 但是,必须为每个传感器(而不是每个设备)单独跟踪这些 ID,因为类扩展可能会为同一设备上的多个传感器提供相同的指针值。
有关如何使用此方法的详细信息,请参阅 筛选数据。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | sensorsclassextension.h |
Library | SensorsClassExtension.lib |