ISensorDriver：：OnClientConnect 方法（sensorsclassextension.h）

ISensorDriver：：OnClientConnect 方法通知传感器驱动程序客户端应用程序已连接。

语法

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

参数

pClientFile

指向 IWDFFile 接口的指针，该接口表示请求连接的应用程序的文件对象。

pwszSensorID

LPWSTR，其中包含客户端应用程序要连接到的传感器的 ID。

返回值

如果作成功，此方法将返回S_OK。 否则，此方法返回在 Winerror.h 中定义的错误代码之一。

言论

传感器类扩展仅在用户已授予访问驱动程序的指定客户端应用程序的权限时调用此方法。 如果用户撤销此权限，类扩展会立即针对同一应用程序/传感器对调用 ISensorDriver：：OnClientDisconnect。

类扩展始终在 ISensorDriver：：OnSetProperties 或 ISensorDriver：：OnGetDataFields 特定传感器之前调用此方法。 建议维护连接的应用程序的引用计数，以帮助预测何时可以调用这三种方法。 如果未连接任何客户端应用程序，则可能需要通过采取措施来降低能耗来更改驱动程序的行为。

可以使用 pClientFile 提供的指针值（指向的地址）作为一种 ID 来跟踪连接的应用程序。 但是，必须为每个传感器单独跟踪这些 ID，而不是针对每个设备，因为类扩展可以为同一设备上多个传感器提供相同的指针值。

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

要求

另请参阅

ISensorDriver