共用方式為


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

另請參閱

ISensorDriver

ISensorDriver::OnGetProperties