「感應器和位置」平台會定義常數，以識別感應器屬性。 感測器製造商也可以定義自己的屬性。
平臺會定義感應器屬性的下列 PROPERTYKEY 值。 除非另有說明，否則這些屬性是唯讀的。
每個平臺定義的感應器屬性 PROPERTYKEY 都是以名為 SENSOR_PROPERTY_COMMON_GUID 的通用 GUID 為基礎：
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
這很重要
請勿使用此基底值來定義您自己的內容索引鍵。
指定為讀取/寫入的屬性值可以由用戶端應用程式指定。 指定為靜電的屬性值不得隨著時間而變更。 感測器必須支援視需要指定的屬性。
| 屬性索引鍵名稱和 PID | Description |
|---|---|
|
VT_UNKNOWN 唯讀。 IPortableDeviceValues 物件，其中包含感應器資料類型名稱及其相關聯的精確度。 準確度值代表與真實值的可能變化。 精確度值會使用與資料欄位相同的單位來表示，除非另有記載。 |
|
VT_UNKNOWN 讀取/寫入。 IPortableDeviceValues 物件，其中包含感應器資料類型名稱及其相關聯的變更敏感度值。 變更敏感度值會提供有關在引發SENSOR_EVENT_DATA_UPDATED事件之前資料欄位應變更的數量的要求。 敏感度值是使用與資料欄位相同的單位來表示，除非另有記載。 對於某些感測器，變化靈敏度會解譯為實際值。 例如，SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS的變更敏感度值為 2，代表正負 2 攝氏度的敏感度。 對於其他感測器，例如環境光感測器 （ALS），變化靈敏度會解譯為百分比。 因此，SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX 的變化敏感度為 2 代表 LUX 的正負 2%。 您可以設定此值來要求特定的變更敏感度，但多個應用程式可能會使用相同的感應器。 因此，感測器會根據其內部邏輯來確定真正的變化靈敏度。 例如，感測器可能一律使用任何應用程式所要求的最小變更敏感度。 如果應用程式將此屬性設定為 VT_NULL，裝置驅動程式會將SENSOR_PROPERTY_CHANGE_SENSITIVITY重設為其預設值。 |
|
VT_UI4 唯讀。 SensorConnectionType 值，其中包含目前的連線類型。 |
|
VT_UI4 讀取/寫入。 產生感測器資料報告的目前經歷時間，以毫秒為單位。 設定零值會向驅動程式發出使用其預設報告間隔的訊號。 收到此屬性的零值之後，驅動程式必須在查詢時傳回其預設報表間隔，而不是零。 應用程式可以設定此值來要求特定的報告間隔，但多個應用程式可能會使用相同的驅動程式。 因此，驅動程式會根據內部邏輯來判斷真正的報告間隔。 例如，驅動程式可能一律使用任何呼叫端所要求的最短報告間隔。 如需如何使用此屬性的範例，請參閱 使用感測器 API 事件。 |
|
VT_LPWSTR 唯讀。 感測器描述字串。 |
|
VT_LPWSTR 唯讀。 唯一識別與感應器相關聯的裝置實例。 您可以使用此屬性來判斷裝置是否包含多個感應器。 裝置驅動程式不需要支援此屬性，因為平臺會將此值提供給應用程式，而不需要查詢驅動程式。 |
|
VT_LPWSTR 唯讀。 必要，靜態。 裝置的易記名稱。 |
|
VT_UI4 唯讀。 提供此屬性，讓 HID 感應器製造商和驅動程式開發人員能夠識別 API 層中浮現的感應器，其易記名稱為 「未知」。 |
|
VT_VECTOR|VT_UI1 唯讀。 計數陣列，其中包含提供環境光等級與位移之間對映的值對對。 這些值以百分比表示。 Windows 中的調適性亮度功能會將這些值套用至使用者目前的顯示器亮度喜好設定。 向量類型的資料一律會序列化為 VT_UI1 （未帶正負號的 1 位元組字元陣列）。 此屬性實際上包含每個值作為 4 位元組的無符號整數 （VT_UI4） 。 如需使用陣列的相關資訊，請參閱 擷取向量類型。 |
|
VT_UI4 讀取/寫入。 LOCATION_DESIRED_ACCURACY列舉中的值，指出用戶端應用程式所要求的精確度處理類型。 LOCATION_DESIRED_ACCURACY_DEFAULT （0） 表示感測器應使用可以最佳化電源使用和其他成本考量的準確度。 LOCATION_DESIRED_ACCURACY_HIGH （1） 表示感測器應提供盡可能準確的報告。 這包括使用可能收費的服務，或消耗更高等級的電池電量或連線頻寬。 |
|
VT_LPWSTR 唯讀。 必要，靜態。 製造商的名稱。 |
|
VT_UI4 唯讀。 必要，靜態。 硬體支援產生感應器資料報告的最小間隔，以毫秒為單位。 |
|
VT_LPWSTR 唯讀。 必要，靜態。 感測器型號名稱。 |
|
VT_CLSID 唯讀。 必要，靜態。 識別感應器的 GUID 。 對於裝置上的每個感應器，或跨電腦上列舉之相同型號的裝置，此值必須是唯一的。 此屬性包含呼叫 ISensor：：GetID 所取得的相同值。 |
|
VT_UKNOWN 唯讀。 IPortableDeviceValues 物件，其中包含感應器資料欄位名稱及其相關聯的最大值。 |
|
VT_UKNOWN 唯讀。 IPortableDeviceValues 物件，其中包含感應器資料欄位名稱及其相關聯的最小值。 |
|
VT_UKNOWN 唯讀。 IPortableDeviceValues 物件，其中包含感應器資料欄位名稱及其相關聯的解決方案。 解析度值代表資料欄位中變更的敏感度。 解析度值會使用與資料欄位相同的單位來表示，除非另有記載。 |
|
VT_LPWSTR 唯讀。 必要，靜態。 傳感器序號。 |
|
VT_UI4 唯讀。 必須的。 SensorState 值，其中包含目前的感應器狀態。 |
|
VT_CLSID 唯讀。 必要，靜態。 識別感應器類型的 GUID 。 平台定義的感應器類型定義在 Sensors.h 中。 |
所有感應器都必須支援下列 Windows 可攜式裝置 （WPD） 屬性。
| 屬性索引鍵 | Description |
|---|---|
|
VT_CLSID 唯讀。 必要，靜態。 定義感測器類別。 |
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 |
Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
不支援 |
| Header |
|