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 |