Propriétés communes des capteurs
Cet article décrit les propriétés des capteurs qui sont communes à tous les capteurs.
Le tableau suivant montre les propriétés communes. Pour en savoir plus sur les types affichés dans la colonne Type, se reporter à Structure PROPVARIANT.
| Clé de propriété | Type | Accès (R/O, R/W) | Obligatoires/facultatif | Description |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Requis | Le type de capteur. Le GUID consiste en le même format qu’un capteur Windows (par exemple, SENSOR_TYPE_ACCELEROMETER_3D). Pour plus d’informations sur les types de capteurs, veuillez consulter la section GUID des types de capteurs. |
| PKEY_Sensor_State | VT_UI4 | R/O | Requis | L’état du capteur. Pour plus d’informations sur les états des capteurs, veuillez consulter la section SENSOR_STATE. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Requis | L’intervalle de temps minimum (en millisecondes) que le matériel prend en charge pour la génération de rapports de données du capteur. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Requis | La taille maximale renvoyée lors d’un appel ReadFile. Un appel ReadFile permet à l’API native d’allouer un tampon pour contenir tout champ de données. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | Facultatif | La puissance du capteur exprimée en milliwatts. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | Optionnel Mais requis si le capteur prend en charge l’historique. |
La taille maximale des données d’historique du capteur, exprimée en octets. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | Optionnel Mais requis si le capteur prend en charge l’historique. |
L’intervalle d’échantillonnage de l’historique du capteur, exprimé en millisecondes. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | Optionnel Mais requis si le capteur prend en charge l’historique. |
La taille maximale des enregistrements exprimée en octets. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | Optionnel Mais requis si le capteur prend en charge le batching. |
Le nombre d’événements réservés pour ce capteur dans le tampon FIFO (first-in-first-out) pour le batch. Cela garantit un nombre minimum d’événements. Si cette valeur est zéro, il n’y a aucune garantie que le capteur effectue un batching. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | Optionnel Mais requis si le capteur prend en charge le batching. |
Le nombre maximal d’événements qui pourraient être regroupés dans le FIFO. Si cette valeur est zéro, alors le batching n’est pas pris en charge par le capteur. Le nombre réel d’événements pourrait être inférieur à ce nombre puisque le FIFO du batch peut être partagé par plusieurs capteurs. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | Optionnel Mais requis si le capteur prend en charge le batching. |
Indique si le capteur est capable de réveiller. Lorsque qu’un capteur prend en charge le batching de données, cette propriété doit être définie sur VARIANT_TRUE si le capteur peut réveiller le processeur d’application lorsque le FIFO est plein. Et la valeur doit être définie sur VARIANT_FALSE si le capteur ne peut pas réveiller le processeur d’application. Dans ce cas, l’état de cette propriété indique la capacité du capteur à se réveiller de la veille connectée. Si le capteur prend en charge le réveil d’un système depuis l’état SX, cette propriété doit être définie sur VARIANT_TRUE, et si elle ne prend pas en charge le réveil depuis SX, cette propriété doit être définie sur VARIANT_FALSE. |
Batching de données
Un pilote de capteur qui prend en charge le batching de données doit signaler les propriétés communes suivantes :
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
À partir de Windows 10, version 1511, il est désormais possible de mettre en œuvre le batching de données en utilisant le pilote de classe de capteur HID. Pour plus d’informations à ce sujet, veuillez consulter la section Contrôles de batching des capteurs.
Veuillez consulter la section EvtSensorSetBatchLatency pour des informations sur la fonction de rappel liée au batching de données.
Avec la capacité d’un capteur à réveiller le CPU et le système d’exploitation de l’état SX, PKEY_Sensor_WakeCapable est également utilisé comme propriété d’énumération pouvant être interrogée depuis le magasin de pilotes PnP pour déterminer si le capteur est capable de réveiller le système de l’état SX en plus de réveiller le système de la veille connectée.
Notes
Lorsque le pilote client signale les propriétés suivantes, le pilote client doit utiliser CollectionsListGetMarshalledSizeWithoutSerialization au lieu de CollectionsListGetMarshalledSize :
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes