일반적인 센서 속성
이 문서에서는 모든 센서에 공통적인 센서 속성을 설명합니다.
다음 표에는 공통 속성이 표시됩니다. 형식 열에 표시된 형식에 대한 자세한 내용은 PROPVARIANT 구조를 참조하세요.
| 속성 키 | Type | 액세스(R/O, R/W) | 필수/선택 사항 | 설명 |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Required | 센서의 유형입니다. GUID는 Windows 센서와 동일한 형식(예: SENSOR_TYPE_ACCELEROMETER_3D)으로 구성됩니다. 센서 유형에 대한 자세한 내용은 센서 유형 GUID를 참조 하세요. |
| PKEY_Sensor_State | VT_UI4 | R/O | Required | 센서의 상태입니다. 센서 상태에 대한 자세한 내용은 SENSOR_STATE 참조하세요. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Required | 하드웨어에서 센서 데이터 보고서 생성을 지원하는 최소 시간 간격(밀리초)입니다. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Required | ReadFile 호출에서 반환되는 최대 크기입니다. ReadFile 호출을 사용하면 네이티브 API가 버퍼를 할당하여 데이터 필드를 보유할 수 있습니다. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | 선택 사항 | 밀리와트 단위로 표현되는 센서 전력입니다. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | 선택 사항이 지만 센서가 기록을 지원하는 경우 필요합니다. |
센서 기록 데이터의 최대 크기(바이트)입니다. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | 선택 사항이 지만 센서가 기록을 지원하는 경우 필요합니다. |
센서 기록 샘플링 간격(밀리초)입니다. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | 선택 사항이 지만 센서가 기록을 지원하는 경우 필요합니다. |
바이트로 표현된 최대 레코드 크기입니다. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | 선택 사항이 지만 센서가 일괄 처리를 지원하는 경우 필요합니다. |
일괄 처리에 대한 FIFO(fist-in-first-out) 버퍼에서 이 센서에 예약된 이벤트 수입니다. 이렇게 하면 최소 이벤트 수가 보장됩니다. 이 값이 0이면 센서가 일괄 처리를 수행한다는 보장은 없습니다. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | 선택 사항이 지만 센서가 일괄 처리를 지원하는 경우 필요합니다. |
FIFO에서 일괄 처리할 수 있는 최대 이벤트 수입니다. 이 값이 0이면 센서에서 일괄 처리를 지원하지 않습니다. 배치 FIFO는 여러 센서에서 공유할 수 있으므로 실제 이벤트 수는 이 수보다 작을 수 있습니다. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | 선택 사항이 지만 센서가 일괄 처리를 지원하는 경우 필요합니다. |
센서가 절전 모드 해제 가능인지 여부를 나타냅니다. 센서가 센서 일괄 처리를 지원하는 경우 FIFO가 가득 찼을 때 센서가 애플리케이션 프로세서를 절전 모드에서 해제할 수 있는 경우 이 속성을 VARIANT_TRUE 설정해야 합니다. 센서가 애플리케이션 프로세서를 절전 모드에서 해제할 수 없는 경우 값을 VARIANT_FALSE 설정해야 합니다. 이 경우 이 속성의 상태는 센서가 연결된 대기 상태에서 절전 모드를 해제하는 기능을 나타냅니다. 센서가 SX에서 시스템 절전 모드 해제를 지원하는 경우 이 속성은 VARIANT_TRUE 설정해야 하며 SX에서 절전 모드 해제를 지원하지 않는 경우 이 속성을 VARIANT_FALSE 설정해야 합니다. |
데이터 일괄 처리
데이터 일괄 처리를 지원하는 센서 드라이버는 다음과 같은 일반적인 센서 속성을 보고해야 합니다.
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
Windows 10 버전 1511부터 HID 센서 클래스 드라이버를 사용하여 데이터 일괄 처리를 구현하는 데 지원이 제공됩니다. 이에 대한 자세한 내용은 센서 일괄 처리 컨트롤을 참조 하세요.
데이터 일괄 처리와 관련된 콜백 함수에 대한 자세한 내용은 EvtSensorSetBatchLatency를 참조하세요.
센서가 SX 상태에서 CPU 및 운영 체제를 해제하는 기능을 통해 PKEY_Sensor_WakeCapable PnP 드라이버 저장소에서 쿼리하여 연결된 대기 상태에서 시스템을 깨울 뿐만 아니라 SX에서 시스템을 깨울 수 있는지 여부를 확인할 수 있는 열거형 속성으로도 사용됩니다.
설명
클라이언트 드라이버가 다음 속성을 보고하는 경우 클라이언트 드라이버는 CollectionsListGetMarshalledSize 대신 CollectionsListGetMarshalledSizeWithoutSerialization을 사용해야 합니다.
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes