Compartilhar via


EVT_SENSOR_DRIVER_SET_BATCH_LATENCY função de retorno de chamada (sensorscx.h)

Essa função de retorno de chamada define a latência do lote para um sensor especificado.

Sintaxe

EVT_SENSOR_DRIVER_SET_BATCH_LATENCY EvtSensorDriverSetBatchLatency;

NTSTATUS EvtSensorDriverSetBatchLatency(
  [in] SENSOROBJECT Sensor,
  [in] ULONG BatchLatencyMs
)
{...}

Parâmetros

[in] Sensor

Uma referência a um objeto de sensor.

[in] BatchLatencyMs

A latência do lote, expressa em milissegundos.

Valor de retorno

Essa função retorna STATUS_SUCCESS quando concluída com êxito.

Observação A extensão de classe (CX) usa apenas a macro NT_SUCCESS para determinar se a chamada para a função Evt do driver foi bem-sucedida, mas não executa nenhuma ação se a função falhou ou não retorna STATUS_SUCCESS.

Observações

O driver pode definir a latência em lote como um valor menor ou igual a batchLatencyMs, dependendo da disponibilidade do buffer. Para obter informações sobre as propriedades do sensor que um driver de sensor de lote de dados deve relatar, consulte propriedades comuns do sensor.

É importante observar que não há nenhuma alteração implícita nos métodos e eventos de entrega de dados do sensor devido ao envio em lote de dados. Quando a latência do lote de dados expirar, o driver chamará SensorsCxSensorDataReady repetidamente para fornecer todos os exemplos de dados em buffer, um de cada vez. Os exemplos de dados são enviados, juntamente com as informações do carimbo de data/hora em seus campos de dados PKEY_SensorData_Timestamp. As informações do carimbo de data/hora (do tipo de dados VT_FILETIME) mostram o momento em que uma amostra foi obtida.

Para obter mais informações sobre o tipo de dados VT_FILETIME, consulte estrutura PROPVARIANT MSDN.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho sensorscx.h
IRQL requires_same

Consulte também

estrutura PROPVARIANT DO MSDN

SensorsCxSensorDataReady