センサーのプロパティ
センサーと場所プラットフォームでは、センサーのプロパティを識別する定数を定義します。 センサーの製造元は、独自のプロパティを定義することもできます。
プラットフォームでは、センサー プロパティに対して次の PROPERTYKEY 値を定義します。 特に記載がない限り、これらのプロパティは読み取り専用です。
各プラットフォーム定義センサー プロパティ PROPERTYKEY は、SENSOR_PROPERTY_COMMON_GUIDという名前の共通 GUID に 基づいています。
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}。
重要
この基本値を使用して独自のプロパティ キーを定義しないでください。
読み取り/書き込みとして指定されたプロパティの値は、クライアント アプリケーションで指定できます。 static として指定されたプロパティの値は、時間の経過と同時に変更してはなりません。 必須として指定されたプロパティは、センサーでサポートされている必要があります。
| プロパティ キー名と PID | 説明 |
|---|---|
|
VT_UNKNOWN 読み取り専用。 センサー のデータ型名とそれに関連付けられた精度を含む IPortableDeviceValues オブジェクト。 精度の値は、真の値から考えられる変動を表します。 精度の値は、特に文書化されている場合を除き、データ フィールドと同じ単位を使用して表されます。 |
|
VT_UNKNOWN 読み取りと書き込みが可能です。 センサー のデータ型名とそれに関連付けられている変更の秘密度値を含む IPortableDeviceValues オブジェクト。 変更の秘密度の値は、SENSOR_EVENT_DATA_UPDATED イベントが発生する前にデータ フィールドを変更する必要がある量に関する要求を提供します。 秘密度値は、他に記載されている場合を除き、データ フィールドと同じ単位を使用して表されます。 一部のセンサーでは、変更の感度は実際の値として解釈されます。 たとえば、SENSOR_DATA_TYPE_TEMPERATURE_CELSIUSの変更感度値 2 は、摂氏プラスまたはマイナス 2 の感度を表します。 周囲光センサー (ALS) などの他のセンサーの場合、変更の感度はパーセントとして解釈されます。 したがって、SENSOR_DATA_TYPE_LIGHT_LEVEL_LUXの変更感度が 2 の場合、LUX のプラスまたはマイナス 2% が表されます。 この値を設定して特定の変更の秘密度を要求できますが、複数のアプリケーションが同じセンサーを使用している可能性があります。 したがって、センサーは、内部ロジックに基づいて、真の変化の感度を決定します。 たとえば、センサーは常に、任意のアプリケーションによって要求される最小の変更感度を使用する場合があります。 アプリケーションでこのプロパティを VT_NULL に設定すると、デバイス ドライバーはSENSOR_PROPERTY_CHANGE_SENSITIVITYを既定値にリセットします。 |
|
VT_UI4 読み取り専用。 現在の接続の種類を含む SensorConnectionType 値。 |
|
VT_UI4 読み取りと書き込みが可能です。 センサー データ レポート生成の現在の経過時間 (ミリ秒単位)。 値を 0 に設定すると、ドライバーは既定のレポート間隔を使用するように通知されます。 このプロパティの値 0 を受け取った後、ドライバーは、クエリ時に 0 ではなく、既定のレポート間隔を返す必要があります。 アプリケーションはこの値を設定して特定のレポート間隔を要求できますが、複数のアプリケーションが同じドライバーを使用するように設定できます。 そのため、ドライバーは、内部ロジックに基づいて、真のレポート間隔を決定します。 たとえば、ドライバーは常に、任意の呼び出し元によって要求される最短のレポート間隔を使用する場合があります。 このプロパティの使用方法の例については、「 センサー API イベントの使用」を参照してください。 |
|
VT_LPWSTR 読み取り専用。 センサーの説明文字列。 |
|
VT_LPWSTR 読み取り専用。 センサーが関連付けられているデバイス インスタンスを一意に識別します。 このプロパティを使用して、デバイスに複数のセンサーが含まれているかどうかを判断できます。 デバイス ドライバーでは、ドライバーのクエリを実行せずにこの値がアプリケーションに提供されるため、このプロパティをサポートする必要はありません。 |
|
VT_LPWSTR 読み取り専用。 必須、静的。 デバイスのフレンドリ名。 |
|
VT_UI4 読み取り専用。 このプロパティは、HID センサーの製造元とドライバー開発者が、"不明" というフレンドリ名を持つ API レイヤーに表示されるセンサーを識別する手段を持つように提供されます。 |
|
VT_VECTOR|VT_UI1 読み取り専用。 アンビエント ライト レベルとオフセットの間のマッピングを提供する値のペアを含むカウントされた配列。 これらの値はパーセンテージで表されます。 Windows のアダプティブ明るさ機能は、これらの値をユーザーの現在のディスプレイの明るさの設定に適用します。 ベクター型のデータは、常に VT_UI1 としてシリアル化されます (符号なし、1 バイト文字の配列)。 このプロパティには、実際には、各値が 4 バイト符号なし整数 (VT_UI4) として含まれています。 配列の操作の詳細については、「 ベクター型の取得」を参照してください。 |
|
VT_UI4 読み取りと書き込みが可能です。 クライアント アプリケーションによって要求された精度処理の種類を示す 、LOCATION_DESIRED_ACCURACY 列挙からの値。 LOCATION_DESIRED_ACCURACY_DEFAULT (0) は、センサーが電力使用やその他のコストに関する考慮事項を最適化できる精度を使用する必要があることを示します。 LOCATION_DESIRED_ACCURACY_HIGH (1) は、センサーが可能な限り最も正確なレポートを提供する必要があることを示します。 これには有料のサービス、または高いレベルのバッテリ電力または接続帯域幅を消費するサービスの使用が含まれます。 |
|
VT_LPWSTR 読み取り専用。 必須、静的。 製造元の名前。 |
|
VT_UI4 読み取り専用。 必須、静的。 センサー データ レポートの生成にハードウェアがサポートする最小間隔 (ミリ秒単位)。 |
|
VT_LPWSTR 読み取り専用。 必須、静的。 センサー モデル名。 |
|
VT_CLSID 読み取り専用。 必須、静的。 センサーを識別する GUID 。 この値は、デバイス上のセンサーごとに、またはコンピューター上で列挙されたのと同じモデルのデバイス間で一意である必要があります。 このプロパティには、 ISensor::GetID を呼び出して取得したのと同じ値が含まれています。 |
|
VT_UKNOWN 読み取り専用。 センサー データ フィールド名とそれに関連付けられている最大値を含む IPortableDeviceValues オブジェクト。 |
|
VT_UKNOWN 読み取り専用。 センサー データ フィールド名とそれに関連付けられている最小値を含む IPortableDeviceValues オブジェクト。 |
|
VT_UKNOWN 読み取り専用。 センサー データ フィールド名とそれに関連付けられている解像度を含む IPortableDeviceValues オブジェクト。 解像度の値は、データ フィールドで変更する感度を表します。 解像度の値は、特に文書化されている場合を除き、データ フィールドと同じ単位を使用して表されます。 |
|
VT_LPWSTR 読み取り専用。 必須、静的。 センサーのシリアル番号。 |
|
VT_UI4 読み取り専用。 必須。 現在のセンサーの状態を含む SensorState 値。 |
|
VT_CLSID 読み取り専用。 必須、静的。 センサーの種類を識別する GUID 。 プラットフォーム定義のセンサーの種類は Sensors.h で定義されています。 |
次の Windows ポータブル デバイス (WPD) プロパティは、すべてのセンサーでサポートされている必要があります。
| プロパティ キー | 説明 |
|---|---|
|
VT_CLSID 読み取り専用。 必須、静的。 センサー カテゴリを定義します。 |
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| Header |
|
関連項目