通用感測器屬性
本文說明所有感測器通用的感測器屬性。
下表顯示通用屬性。 如需類型數據行中所顯示類型的詳細資訊，請參閱 PROPVARIANT 結構。
| 屬性索引鍵 | 類型 | 存取權（R/O、R/W） | 必要/選用 | 描述 |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | 必要 | 感測器的類型。 GUID 是由與 Windows 感測器相同的格式所組成（例如，SENSOR_TYPE_ACCELEROMETER_3D）。 如需感測器類型的詳細資訊，請參閱 感測器類型 GUID。 |
| PKEY_Sensor_State | VT_UI4 | R/O | 必要 | 感測器的狀態。 如需感測器狀態的詳細資訊，請參閱 SENSOR_STATE。 |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | 必要 | 硬體支援產生感測器數據報告的最低時間間隔（以毫秒為單位）。 |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | 必要 | ReadFile 呼叫中傳回的大小上限。 ReadFile 呼叫可讓原生 API 配置緩衝區來保存任何數據欄位。 |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | 選擇性 | 以米瓦特表示的感測器功率。 |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | 選擇性 但必要，如果感測器支援歷程記錄，則為必要專案。 |
感測器歷程記錄數據的大小上限，以位元組表示。 |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | 選擇性 但必要，如果感測器支援歷程記錄，則為必要專案。 |
感測器歷程記錄取樣間隔，以毫秒表示。 |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | 選擇性 但必要，如果感測器支援歷程記錄，則為必要專案。 |
以位元組表示的最大記錄大小。 |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | 選擇性 但必要，如果感測器支援批處理，則為必要專案。 |
在批次的 fist-in-out （FIFO） 緩衝區中保留給此感測器的事件數目。 這保證事件數目下限。 如果此值為零，則不保證感測器會執行批處理。 |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | 選擇性 但必要，如果感測器支援批處理，則為必要專案。 |
可在 FIFO 中批處理的事件數目上限。 如果此值為零，則感測器不支援批處理。 實際的事件數目可能小於這個數字，因為批次 FIFO 可由多個感測器共用。 |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | 選擇性 但必要，如果感測器支援批處理，則為必要專案。 |
指出感測器是否能夠喚醒。 當感測器支援感測器批處理時，如果感測器可以在 FIFO 已滿時喚醒應用程式處理器，則此屬性應設定為 VARIANT_TRUE。 如果感測器無法喚醒應用程式處理器，則此值應設定為 VARIANT_FALSE。 在此情況下，這個屬性的狀態表示感測器能夠從連線待命喚醒。 如果感測器支援從 SX 喚醒系統，則此屬性應該設定為 VARIANT_TRUE，如果不支援從 SX 喚醒，則此屬性應設定為 VARIANT_FALSE。 |
數據批處理
支援資料批次處理的感測器驅動程式必須報告下列常見的感測器屬性：
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
從 Windows 10 版本 1511 開始，現在支援使用 HID 感測器類別驅動程式實作數據批處理。 如需相關信息，請參閱 感測器批處理控件。
如需與數據批處理相關的回呼函式相關信息，請參閱 EvtSensorSetBatchLatency 。
由於感測器能夠從 SX 狀態喚醒 CPU 和作業系統，PKEY_Sensor_WakeCapable也會作為列舉屬性，可從 PnP 驅動程式存放區查詢，以找出感測器是否能夠從 SX 喚醒系統，以及從連線待命喚醒系統。
備註
當用戶端驅動程序報告下列屬性時，用戶端驅動程式必須使用 CollectionsListGetMarshalledSizeWithoutSerialization ，而不是 CollectionsListGetMarshalledSize：
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes