Important
代わりに UWP センサー API を 使用してください。
COM ベースの Sensor API は非推奨であり、新しいアプリケーションでは使用しないでください。 追加の機能や拡張機能は計画されておらず、サポートは制限されます。
複数のセンサー プロパティを取得します。
構文
HRESULT GetProperties(
[in] IPortableDeviceKeyCollection *pKeys,
[out] IPortableDeviceValues **ppProperties
);
パラメーター
[in] pKeys
要求されるプロパティ値の PROPERTYKEY コレクションを含む IPortableDeviceKeyCollection インターフェイスへのポインター。 サポートされているすべてのプロパティを取得するには 、NULL に設定します。
[out] ppProperties
要求されたプロパティ値へのポインターを受け取る IPortableDeviceValues ポインターのアドレス。
戻り値
このメソッドは HRESULT を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。
| リターン コード | Description |
|---|---|
|
メソッドは成功しました。 |
|
センサー ドライバーは、指定されたプロパティの少なくとも 1 つをサポートしていません。 IPortableDeviceValues インターフェイスから返されるサポートされていない各プロパティ PROPVARIANT には、エラー値が HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) に設定されます。 |
|
ppProperties に対して NULL が渡されました。 |
注釈
このメソッドを使用すると、1 回の呼び出しで、センサーの作成、モデル、シリアル番号などの複数のプロパティの値を取得できます。 1 つのプロパティを取得するには、 ISensor::GetProperty を呼び出します。
IPortableDeviceKeyCollection インターフェイスと IPortableDeviceValues インターフェイスは、Windows ポータブル デバイス API によって定義されます。
例示
センサーからプロパティを取得する方法の例については、「センサーのプロパティの 設定と取得」を参照してください。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | sensorsapi.h |
| Library | Sensorsapi.lib |
| DLL | Sensorsapi.dll |