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

추가 정보

MSDN PROPVARIANT 구조체

SensorsCxSensorDataReady