感應器資料包表物件

感應器資料包表物件包含感應器資料。

若要讓感應器很有用，它必須提供有意義的資料。 資料產生的數量和頻率會因感應器而異。 例如，偵測門是否開啟的感應器會產生少量 布林 資料，而動作感應器可能會持續產生多個資料項目。 為了標準化程式接收資料的方式，感應器 API 會使用感應器資料包告物件。

您可以透過 ISensorDataReport 介面存取感應器資料包表中的資訊。 此介面可讓您擷取資料包表的時間戳記，以便判斷報表中的資訊是否有用。 您可以透過兩種方式擷取資料本身：作為個別資料欄值或一組值。 若要以個別值的形式擷取資料，請呼叫 GetSensorValue 方法。 若要擷取多個值，請呼叫 GetSensorValues 方法。

您可以使用 PROPERTYKEY 常數，指定要從報表擷取的資料類型或資料欄位。 常見感應器類型之資料欄位的屬性索引鍵定義于 Sensors.h 中。