ISensorDriver：：OnGetDataFields 方法 (sensorsclassextension.h)
ISensorDriver：：OnGetDataFields 方法會擷取目前的感測器數據。
語法
HRESULT OnGetDataFields(
IWDFFile *pClientFile,
LPWSTR pwszSensorID,
IPortableDeviceKeyCollection *pDataFields,
IPortableDeviceValues **ppDataValues
);
參數
pClientFile
IWDFFile 介面的指標，代表要求數據之應用程式的檔案物件。
pwszSensorID
LPWSTR，其中包含用戶端應用程式要求數據的感測器標識碼。
pDataFields
IPortableDeviceKeyCollection 的指標，其中包含代表所要求之數據欄位的 PROPERTYKEY 值清單。
ppDataValues
接收要求數據的 IPortableDeviceValues 指標位址。
傳回值
這個方法會傳回 HRESULT。 可能的值包括下列其中一個值，但不限於下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
| S_OK | 此方法已成功。 |
| HRESULT_FROM_WIN32 (ERROR_NO_DATA) | 感測器沒有要報告的數據。 ppDataValues 參數中傳回的每個數據欄位都會VT_EMPTY。 |
備註
數據欄位包含感測器產生的數據，而不是描述感測器裝置的屬性。 平台定義的數據欄位定義於 sensors.h 中。
這個方法傳回的每個 IPortableDeviceValues 物件都必須包含時間戳，如 SENSOR_CATEGORY_ALL中所述。
感測器類別延伸負責釋放此方法傳回的任何 PROPVARIANT 結構。
感測器類別延伸模組只會針對使用者透過 控制台 授與許可權的感測器呼叫此方法。
IPortableDeviceKeyCollection 和 IPortableDeviceValues 記載於 Windows 可攜式裝置中。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | sensorsclassextension.h |
| 程式庫 | SensorsClassExtension.lib |