共用方式為

ISensorDriver：：OnGetProperties 方法 (sensorsclassextension.h)

  • 發行項

ISensorDriver：：OnGetProperties 方法會從指定的感測器擷取指定屬性的值。

語法

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

參數

pClientFile

IWDFFile 介面的指標，代表要求屬性值之應用程式的檔案物件。

pwszSensorID

LPWSTR，其中包含用戶端應用程式要求屬性值之感測器的標識碼。

pProperties

IPortableDeviceKeyCollection 的指標，其中包含代表所要求屬性的 PROPERTYKEY 值清單。

ppPropertyValues

接收所要求屬性值的 IPortableDeviceValues 指標位址。

傳回值

如果作業成功，這個方法會傳回S_OK。 否則，這個方法會傳回 Winerror.h 中定義的其中一個錯誤碼。

備註

屬性會描述感測器裝置，而不是包含感測器產生數據的數據欄位。 平台定義屬性定義於 sensors.h 中。

應用程式可以在使用者授與感測器許可權之前存取某些感測器屬性資訊。 這些專案僅限於 sensors.h 中定義的下列識別碼：

  • 任何以 「SENSOR_PROPERTY_」 開頭的 PROPERTYKEY 。
  • 以 「SENSOR_CATEGORY_」 開頭的任何類別 GUID 。
此集合中傳回的每個 IPortableDeviceValues 物件都必須包含必要屬性的值，如 感測器屬性 參考一節中所述。

感測器類別延伸負責釋放這個方法所傳回的任何 PROPVARIANT 結構。

感測器屬性不得包含可用來識別用戶的資訊。 如需用戶隱私權的詳細資訊，請參閱 感測器和位置平臺中的隱私權和安全性。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 記載於 Windows 可攜式裝置中。

規格需求

需求 值
目標平台 Windows
標頭 sensorsclassextension.h
程式庫 SensorsClassExtension.lib

另請參閱

ISensorDriver