Proprietà comuni dei sensori
Questo articolo descrive le proprietà del sensore comuni per tutti i sensori.
Nella tabella seguente vengono illustrate le proprietà comuni. Per altre informazioni sui tipi visualizzati nella colonna di tipo, vedere Struttura PROPVARIANT.
| Chiave della proprietà | Type | Accesso (R/O, R/W) | Obbligatorio/facoltativo | Descrizione |
|---|---|---|---|---|
| PKEY_Sensor_Type | VT_CLSID | R/O | Richiesto | Tipo di sensore. Il GUID è costituito dallo stesso formato di un sensore di Windows (ad esempio, SENSOR_TYPE_ACCELEROMETER_3D). Per altre informazioni sui tipi di sensore, vedere GUID del tipo di sensore. |
| PKEY_Sensor_State | VT_UI4 | R/O | Richiesto | Stato del sensore. Per altre informazioni sugli stati dei sensori, vedere SENSOR_STATE. |
| PKEY_Sensor_MinimumDataInterval_Ms | VT_UI4 | R/O | Richiesto | Intervallo di tempo minimo (in millisecondi) supportato dall'hardware per la generazione di report dei dati del sensore. |
| PKEY_Sensor_MaximumDataFieldSize_Bytes | VT_UI4 | R/O | Richiesto | Dimensione massima restituita in una chiamata ReadFile. Una chiamata ReadFile consente all'API nativa di allocare un buffer per contenere qualsiasi campo dati. |
| PKEY_Sensor_Power_Milliwatts | VT_R4 | R/O | Facoltativo | Potenza del sensore espressa in milliwatt. |
| PKEY_SensorHistory_MaxSize_Bytes | VT_UI4 | R/O | Facoltativo ma obbligatorio, se il sensore supporta la cronologia . |
Dimensione massima dei dati della cronologia dei sensori, espressa in byte. |
| PKEY_SensorHistory_Interval_Ms | VT_UI4 | R/O | Facoltativo ma obbligatorio, se il sensore supporta la cronologia . |
Intervallo di campionamento della cronologia del sensore espresso in millisecondi. |
| PKEY_SensorHistory_MaximumRecordSize_Bytes | VT_UI4 | R/O | Facoltativo ma obbligatorio, se il sensore supporta la cronologia . |
Dimensione massima del record espressa in byte. |
| PKEY_Sensor_FifoReservedSize_Samples | VT_UI4 | R/O | Facoltativo ma obbligatorio, se il sensore supporta l'invio in batch. |
Numero di eventi riservati per questo sensore nel buffer FIFO (Fist-in-first-out) per il batch. Ciò garantisce un numero minimo di eventi. Se questo valore è zero, non esiste alcuna garanzia che il sensore esegua l'invio in batch. |
| PKEY_Sensor_FifoMaxSize_Samples | VT_UI4 | R/O | Facoltativo ma obbligatorio, se il sensore supporta l'invio in batch. |
Numero massimo di eventi che possono essere inseriti in batch in FIFO. Se questo valore è zero, l'invio in batch non è supportato dal sensore. Il numero effettivo di eventi potrebbe essere inferiore a questo numero perché il batch FIFO può essere condiviso da più sensori. |
| PKEY_Sensor_WakeCapable | VT_BOOL | R/O | Facoltativo ma obbligatorio, se il sensore supporta l'invio in batch. |
Indica se il sensore è in grado di riattivare. Quando un sensore supporta l'invio in batch di sensori, questa proprietà deve essere impostata su VARIANT_TRUE, se il sensore può riattivare il processore dell'applicazione quando fifo è pieno. E il valore deve essere impostato su VARIANT_FALSE, se il sensore non è in grado di riattivare il processore dell'applicazione. In questo caso, lo stato di questa proprietà indica la capacità del sensore di riattivare dalla modalità standby connessa. Se il sensore supporta la riattivazione di un sistema da SX, questa proprietà deve essere impostata su VARIANT_TRUE e, se non supporta la riattivazione da SX, questa proprietà deve essere impostata su VARIANT_FALSE. |
Invio in batch di dati
Un driver del sensore che supporta l'invio in batch di dati deve segnalare le proprietà comuni del sensore seguenti:
- PKEY_Sensor_FifoReservedSize_Samples
- PKEY_Sensor_FifoMaxSize_Samples
- PKEY_Sensor_WakeCapable
A partire da Windows 10, versione 1511, il supporto è ora disponibile per l'implementazione di batch di dati tramite il driver di classe del sensore HID. Per informazioni su questo argomento, vedere Controlli di invio in batch dei sensori.
Per informazioni sulla funzione di callback correlata all'invio in batch di dati, vedere EvtSensorSetBatchLatency .
Con la capacità di un sensore di riattivare la CPU e il sistema operativo dallo stato SX, PKEY_Sensor_WakeCapable viene usato anche come proprietà di enumerazione che può essere eseguita una query dall'archivio driver PnP per scoprire se il sensore è in grado di svegliare il sistema da SX oltre a svegliare il sistema dallo standby connesso.
Osservazioni:
Quando il driver client segnala le proprietà seguenti, il driver client deve usare CollectionsListGetMarshalledSizeWithoutSerialization anziché CollectionsListGetMarshalledSize:
- PKEY_SensorHistory_MaxSize_Bytes
- PKEY_SensorHistory_MaximumRecordSize_Bytes