共用方式為


應用程式開發的一般需求

這很重要

請改用 UWP 感應器 API

COM 型感測器 API 已被取代,不應該用於新的應用程式。 沒有計劃提供其他功能或增強功能,並且支援將受到限制。

本主題描述您必須執行的動作,才能開始建立使用感測器 API 的程式。

若要建立感測器 API 應用程式,您必須在電腦上安裝 Windows 7 和 Windows 7 軟體開發工具包 (SDK)。 下表描述您將需要的特定檔案。

檔名 描述
Sensorsapi.h 感測器 API 的主要標頭檔。 這個頭檔包含介面定義。
Sensors.h 包含平台定義常數定義的頭檔。
Initguid.h 頭檔,其中包含控制 GUID 初始化的定義。
FunctionDiscoveryKeys.h 標頭檔,定義連線到邏輯感測器時所需的裝置識別碼屬性金鑰。
Sensorsapi.lib 靜態庫,包含感測器 API 的 GUID 定義。
PortableDeviceGuids.lib 靜態庫,其中包含 Windows 可攜式裝置物件的 GUID 定義。

您的程式可能需要其他檔案。

支援的作系統

除了 Windows 7 入門版以外,感測器 API 應用程式將會在所有 Windows 7 版本上執行。

Windows 可攜式裝置介面

感測器 API 會使用特定 Windows 可攜式裝置 (WPD) 物件來封裝屬性索引鍵和值。 下表描述這些物件的介面。

介面 描述
IPortableDeviceValues 此介面提供方便的方式,可建立名稱/值組的屬性包。 名稱會以 PROPERTYKEY 來表示,而值則以 PROPVARIANT表示。
API 會使用此介面來設定和擷取單一值和值集。 這個介面可以從方法擷取,或者,如果需要新的物件,請呼叫具有CLSID_PortableDeviceValues的CoCreateInstance
IPortableDeviceKeyCollection 這個介面包含 PROPERTYKEY的集合。 這些索引鍵代表可由 IPortableDeviceValues 儲存的屬性名稱。 API 會使用此集合物件來設定和擷取單一屬性名稱和屬性名稱集合。
這個介面可以從方法擷取,或者,如果需要新的物件,請呼叫具有CLSID_PortableDeviceKeyCollection的CoCreateInstance