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
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 |
程式庫 | SensorsClassExtension.lib |