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，因为类扩展可能会为同一设备上的多个传感器提供相同的指针值。

有关如何使用此方法的详细信息，请参阅 筛选数据。

要求

另请参阅

ISensorDriver