EVT_SENSOR_DRIVER_SET_BATCH_LATENCY Rückruffunktion (sensorscx.h)
Diese Rückruffunktion legt die Batchlatenz für einen angegebenen Sensor fest.
Syntax
EVT_SENSOR_DRIVER_SET_BATCH_LATENCY EvtSensorDriverSetBatchLatency;
NTSTATUS EvtSensorDriverSetBatchLatency(
[in] SENSOROBJECT Sensor,
[in] ULONG BatchLatencyMs
)
{...}
Parameter
[in] Sensor
Ein Verweis auf ein Sensorobjekt.
[in] BatchLatencyMs
Die Batchlatenz, ausgedrückt in Millisekunden.
Rückgabewert
Diese Funktion gibt STATUS_SUCCESS zurück, wenn sie erfolgreich abgeschlossen wurde.
Hinweis Die Klassenerweiterung (CX) verwendet nur das NT_SUCCESS Makro, um zu ermitteln, ob der Aufruf der Evt-Funktion des Treibers erfolgreich war, aber keine Aktion ausführt, wenn die Funktion fehlgeschlagen ist oder STATUS_SUCCESS nicht zurückgegeben wird.
Bemerkungen
Der Treiber kann die Batchlatenz je nach Pufferverfügbarkeit auf einen Wert festlegen, der kleiner oder gleich BatchLatencyMsist. Informationen zu den Sensoreigenschaften, die ein Datenbatchsensortreiber melden muss, finden Sie unter Allgemeinen Sensoreigenschaften.
Es ist wichtig zu beachten, dass aufgrund der Datenbatchierung keine Änderung an Sensordatenübermittlungsmethoden und -ereignissen impliziert wird. Wenn die Datenbatchlatenz abläuft, ruft der Treiber SensorsCxSensorDataReady- wiederholt auf, um alle gepufferten Datenbeispiele einzeln bereitzustellen. Die Datenbeispiele werden zusammen mit den Zeitstempelinformationen in ihren PKEY_SensorData_Timestamp Datenfeldern gesendet. Die Zeitstempelinformationen (vom Datentyp VT_FILETIME) zeigen die Zeit an, zu der ein Beispiel aufgenommen wurde.
Weitere Informationen zum VT_FILETIME Datentyp finden Sie unter MSDN PROPVARIANT-Struktur.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Fenster |
Header- | sensorscx.h |
IRQL- | requires_same |