ISensorDriver::OnSetProperties 方法 (sensorsclassextension.h)

ISensorDriver::OnSetProperties 方法指定指定属性列表的值。

语法

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

参数

[in] pClientFile

指向 IWDFFile 接口的指针,该接口表示指定属性值的应用程序的文件对象。

[in] pwszSensorID

包含客户端应用程序为其指定属性值的传感器的 ID 的 LPWSTR

[in] pPropertiesToSet

指向 IPortableDeviceValues 接口的 指针,该接口包含要设置的属性列表及其值。

[out] ppResults

接收已成功设置的属性列表及其新值的 IPortableDeviceValues 指针的地址。 如果未设置属性,则新值将包含 HRESULT 错误代码。

返回值

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

注解

属性描述传感器设备,而不是包含传感器生成的数据的数据字段。 平台定义的属性在 sensors.h 中定义。

通过 pPropertiesToSet 提供的属性列表通常是通过 ISensorDriver::OnGetSupportedProperties 返回的列表的子集。 但是,传感器类扩展不会在客户端应用程序上强制实施此条件。

传感器类扩展负责释放此方法返回的任何 PROPVARIANT 结构。

IPortableDeviceValues 记录在 Windows 可移植设备中。

注意 仅当用户在 “位置和其他 传感器”控制面板中启用了传感器时,才会调用此方法。
 

要求

要求
最低受支持的客户端 Windows 7,在 Windows 7 中可用。
最低受支持的服务器 无受支持的版本
目标平台 桌面
标头 sensorsclassextension.h
Library SensorsClassExtension.lib

另请参阅

ISensorDriver

ISensorDriver::OnGetProperties