fonction de rappel EVT_SENSOR_DRIVER_SET_BATCH_LATENCY (sensorscx.h)
Cette fonction de rappel définit la latence de lot pour un capteur spécifié.
Syntaxe
EVT_SENSOR_DRIVER_SET_BATCH_LATENCY EvtSensorDriverSetBatchLatency;
NTSTATUS EvtSensorDriverSetBatchLatency(
[in] SENSOROBJECT Sensor,
[in] ULONG BatchLatencyMs
)
{...}
Paramètres
[in] Sensor
Référence à un objet capteur.
[in] BatchLatencyMs
Latence du lot, exprimée en millisecondes.
Valeur de retour
Cette fonction retourne STATUS_SUCCESS une fois terminée.
Remarque L’extension de classe (CX) utilise uniquement la macro NT_SUCCESS pour déterminer si l’appel à la fonction Evt du pilote a réussi, mais n’effectue aucune action si la fonction a échoué ou ne retourne pas STATUS_SUCCESS.
Remarques
Le pilote peut définir la latence du lot sur une valeur inférieure ou égale à BatchLatencyMs, en fonction de la disponibilité de la mémoire tampon. Pour plus d’informations sur les propriétés du capteur qu’un pilote de capteur de traitement par lots de données doit signaler, consultez propriétés de capteur courantes.
Il est important de noter qu’il n’existe aucune modification implicite des méthodes et événements de remise des données du capteur, en raison du traitement par lot des données. Lorsque la latence de traitement par lots de données expire, le pilote appelle SensorsCxSensorDataReady à plusieurs reprises pour fournir tous les exemples de données mis en mémoire tampon, un par un. Les exemples de données sont envoyés, ainsi que les informations d’horodatage dans leurs champs de données PKEY_SensorData_Timestamp. Les informations d’horodatage (de type de données VT_FILETIME) indiquent l’heure à laquelle un échantillon a été prélevé.
Pour plus d’informations sur le type de données VT_FILETIME, consultez structure MSDN PROPVARIANT.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorscx.h |
| IRQL | requires_same |