센서 속성
센서 및 위치 플랫폼은 센서의 속성을 식별하는 상수를 정의합니다. 센서 제조업체는 자체 속성을 정의할 수도 있습니다.
플랫폼은 센서 속성에 대해 다음 PROPERTYKEY 값을 정의합니다. 이러한 속성은 달리 명시되지 않는 한 읽기 전용입니다.
각 플랫폼 정의 센서 속성 PROPERTYKEY 는 SENSOR_PROPERTY_COMMON_GUID 라는 공통 GUID 를 기반으로 합니다.
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
중요
이 기본 값을 사용하여 고유한 속성 키를 정의하지 마세요.
읽기/쓰기로 지정된 속성의 값은 클라이언트 애플리케이션에서 지정할 수 있습니다. 정적으로 지정된 속성의 값은 시간이 지남에 따라 변경되지 않아야 합니다. 필요에 따라 지정된 속성은 센서에서 지원되어야 합니다.
| 속성 키 이름 및 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 읽기 전용입니다. 센서가 연결된 디바이스 instance 고유하게 식별합니다. 이 속성을 사용하여 디바이스에 여러 센서가 포함되어 있는지 여부를 확인할 수 있습니다. 플랫폼이 드라이버를 쿼리하지 않고도 애플리케이션에 이 값을 제공하기 때문에 디바이스 드라이버는 이 속성을 지원할 필요가 없습니다. |
|
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에 정의되어 있습니다. |
다음 WPD(Windows 이식 장치) 속성은 모든 센서에서 지원되어야 합니다.
| 속성 키 | Description |
|---|---|
|
VT_CLSID 읽기 전용입니다. 필수, 정적. 센서 범주를 정의합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
추가 정보