EVT_SENSOR_DRIVER_SET_BATCH_LATENCY 콜백 함수(sensorscx.h)
이 콜백 함수는 지정된 센서의 일괄 처리 대기 시간을 설정합니다.
구문
EVT_SENSOR_DRIVER_SET_BATCH_LATENCY EvtSensorDriverSetBatchLatency;
NTSTATUS EvtSensorDriverSetBatchLatency(
[in] SENSOROBJECT Sensor,
[in] ULONG BatchLatencyMs
)
{...}
매개 변수
[in] Sensor
센서 개체에 대한 참조입니다.
[in] BatchLatencyMs
일괄 처리 대기 시간(밀리초)입니다.
반환 값
이 함수는 성공적으로 완료되면 STATUS_SUCCESS 반환합니다.
참고 CX(클래스 확장)는 NT_SUCCESS 매크로만 사용하여 드라이버의 Evt 함수 호출이 성공했는지 확인하지만 함수가 실패했거나 STATUS_SUCCESS 반환하지 않는 경우 아무 작업도 수행하지 않습니다.
설명
드라이버는 버퍼 가용성에 따라 일괄 처리 대기 시간을 BatchLatencyMs보다 작거나 같은 값으로 설정할 수 있습니다. 데이터 일괄 처리 센서 드라이버에서 보고해야 하는 센서 속성에 대한 자세한 내용은 일반 센서 속성을 참조하세요.
데이터 일괄 처리로 인해 센서 데이터 배달 방법 및 이벤트에 암시된 변경 내용은 없다는 점에 유의해야 합니다. 데이터 일괄 처리 대기 시간이 만료되면 드라이버는 SensorsCxSensorDataReady 를 반복적으로 호출하여 버퍼링된 모든 데이터 샘플을 한 번에 하나씩 전달합니다. 데이터 샘플은 PKEY_SensorData_Timestamp 데이터 필드의 타임스탬프 정보와 함께 전송됩니다. 타임스탬프 정보(VT_FILETIME 데이터 형식)는 샘플이 수행된 시간을 보여 줍니다.
VT_FILETIME 데이터 형식에 대한 자세한 내용은 MSDN PROPVARIANT 구조를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | sensorscx.h |
| IRQL | requires_same |