EVT_SENSOR_DRIVER_SET_BATCH_LATENCY funzione di callback (sensorscx.h)
Questa funzione di callback imposta la latenza batch per un sensore specificato.
Sintassi
EVT_SENSOR_DRIVER_SET_BATCH_LATENCY EvtSensorDriverSetBatchLatency;
NTSTATUS EvtSensorDriverSetBatchLatency(
[in] SENSOROBJECT Sensor,
[in] ULONG BatchLatencyMs
)
{...}
Parametri
[in] Sensor
Riferimento a un oggetto sensore.
[in] BatchLatencyMs
Latenza batch espressa in millisecondi.
Valore restituito
Questa funzione restituisce STATUS_SUCCESS al termine dell'operazione.
Nota L'estensione della classe (CX) usa solo la macro NT_SUCCESS per determinare se la chiamata alla funzione Evt del driver ha avuto esito positivo, ma non esegue alcuna azione se la funzione ha avuto esito negativo o non restituisce STATUS_SUCCESS.
Osservazioni
Il driver può impostare la latenza batch su un valore minore o uguale a BatchLatencyMs, a seconda della disponibilità del buffer. Per informazioni sulle proprietà del sensore che un driver del sensore di invio in batch di dati deve segnalare, vedere Proprietà comuni del sensore.
È importante notare che non vi sono modifiche implicite ai metodi e agli eventi di recapito dei dati dei sensori, a causa dell'invio in batch dei dati. Quando scade la latenza di invio in batch dei dati, il driver chiamerà SensorsCxSensorDataReady ripetutamente per recapitare tutti gli esempi di dati memorizzati nel buffer, uno alla volta. Gli esempi di dati vengono inviati, insieme alle informazioni sul timestamp nei relativi campi dati PKEY_SensorData_Timestamp. Le informazioni sul timestamp (di tipo di dati VT_FILETIME) mostrano l'ora in cui è stato acquisito un campione.
Per altre informazioni sul tipo di dati VT_FILETIME, vedere struttura MSDN PROPVARIANT.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | sensorscx.h |
| IRQL | requires_same |