Proprietà del sensore
La piattaforma Sensor and Location definisce costanti che identificano le proprietà per i sensori. I produttori di sensori possono anche definire le proprie proprietà.
La piattaforma definisce i valori PROPERTYKEY seguenti per le proprietà del sensore. Queste proprietà sono di sola lettura, a meno che non sia diversamente indicato.
Ogni proprietà del sensore definita dalla piattaforma è basata su un GUID comune denominato SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Importante
Non usare questo valore di base per definire le proprie chiavi di proprietà.
I valori per le proprietà designati come lettura/scrittura possono essere specificati dall'applicazione client. I valori per le proprietà designati come statici non devono cambiare nel tempo. Le proprietà definite come necessarie devono essere supportate dal sensore.
| Nome della chiave di proprietà e PID | Descrizione |
|---|---|
|
VT_UNKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene nomi dei tipi di dati del sensore e le relative accuratezze associate. I valori di accuratezza rappresentano la possibile variazione dei valori true. I valori di accuratezza vengono espressi usando le stesse unità del campo dati, tranne se altrimenti documentate. |
|
VT_UNKNOWN Proprietà di lettura/scrittura. Oggetto IPortableDeviceValues che contiene nomi dei tipi di dati del sensore e i relativi valori di riservatezza delle modifiche associati. Modificare i valori di riservatezza forniscono richieste relative alla quantità in base alla quale il campo dati deve cambiare prima che venga generato l'evento SENSOR_EVENT_DATA_UPDATED. I valori di riservatezza vengono espressi usando le stesse unità del campo dati, ad eccezione della posizione diversamente documentata. Per alcuni sensori, la riservatezza delle modifiche viene interpretata come valore effettivo. Ad esempio, un valore di riservatezza di modifica pari a 2 per SENSOR_DATA_TYPE_TEMPERATURE_CELSIUS rappresenta una sensibilità di più o meno 2 gradi Celsius. Per altri sensori, ad esempio il sensore di luce ambientale (ALS), la riservatezza delle modifiche viene interpretata come percentuale. Quindi, una sensibilità di modifica pari a 2 per SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX rappresenta più o meno il 2% di LUX. È possibile impostare questo valore per richiedere una particolare riservatezza delle modifiche, ma più applicazioni potrebbero usare lo stesso sensore. Pertanto, i sensori determinano la vera riservatezza delle modifiche, in base alla logica interna. Ad esempio, il sensore potrebbe usare sempre la sensibilità di modifica più piccola richiesta da una qualsiasi delle applicazioni. Se un'applicazione imposta questa proprietà su VT_NULL, il driver del dispositivo reimposta SENSOR_PROPERTY_CHANGE_SENSITIVITY al relativo valore predefinito. |
|
VT_UI4 Sola lettura. Valore SensorConnectionType contenente il tipo di connessione corrente. |
|
VT_UI4 Proprietà di lettura/scrittura. Tempo trascorso corrente per la generazione di report dei dati del sensore, in millisecondi. L'impostazione di un valore pari a zero segnala al driver di usare l'intervallo di report predefinito. Dopo aver ricevuto un valore pari a zero per questa proprietà, un driver deve restituire l'intervallo di report predefinito, non zero, quando viene eseguita una query. Le applicazioni possono impostare questo valore per richiedere un determinato intervallo di report, ma più applicazioni possono usare lo stesso driver. Pertanto, i driver determinano l'intervallo di report vero, in base alla logica interna. Ad esempio, il driver potrebbe usare sempre l'intervallo di report più breve richiesto da qualsiasi chiamante. Per un esempio di come usare questa proprietà, vedere Uso di eventi API sensore. |
|
VT_LPWSTR Sola lettura. Stringa di descrizione del sensore. |
|
VT_LPWSTR Sola lettura. Identifica in modo univoco l'istanza del dispositivo con cui è associato il sensore. È possibile usare questa proprietà per determinare se un dispositivo contiene più sensori. I driver di dispositivo non devono supportare questa proprietà perché la piattaforma fornisce questo valore alle applicazioni senza eseguire query sui driver. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Nome descrittivo per il dispositivo. |
|
VT_UI4 Sola lettura. Questa proprietà viene fornita in modo che i produttori di sensori HID e gli sviluppatori di driver dispongano di un mezzo per identificare un sensore che superfici nel livello API con un nome descrittivo di "sconosciuto". |
|
VT_VECTOR| VT_UI1 Sola lettura. Matrice conteggiata che contiene coppie di valori che forniscono un mapping tra i livelli di luce ambientale e gli offset. Questi valori vengono espressi come percentuali. La funzionalità di luminosità adattiva in Windows applica questi valori alla preferenza di luminosità di visualizzazione corrente dell'utente. I dati per i tipi di vettore vengono sempre serializzati come VT_UI1 (matrice di caratteri senza segno, 1 byte). Questa proprietà contiene effettivamente ogni valore come intero senza segno a 4 byte (VT_UI4). Per informazioni sull'uso di matrici, vedere Recupero di tipi di vettore. |
|
VT_UI4 Proprietà di lettura/scrittura. Valore dell'enumerazione LOCATION_DESIRED_ACCURACY che indica il tipo di gestione dell'accuratezza richiesta da un'applicazione client. LOCATION_DESIRED_ACCURACY_DEFAULT (0) indica che il sensore deve usare l'accuratezza per cui può ottimizzare l'utilizzo di energia e altre considerazioni sui costi. LOCATION_DESIRED_ACCURACY_HIGH (1) indica che il sensore deve fornire il report più accurato possibile. È incluso l'utilizzo di servizi a pagamento o il consumo maggiore della batteria o della larghezza di banda della connessione. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Nome del produttore. |
|
VT_UI4 Sola lettura. Obbligatorio, statico. Intervallo minimo supportato dall'hardware per la generazione di report dei dati del sensore, in millisecondi. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Nome del modello di sensore. |
|
VT_CLSID Sola lettura. Obbligatorio, statico. GUID che identifica il sensore. Questo valore deve essere univoco per ogni sensore in un dispositivo o tra dispositivi dello stesso modello enumerato nel computer. Questa proprietà contiene lo stesso valore ottenuto chiamando ISensor::GetID . |
|
VT_UKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene i nomi dei campi dei dati del sensore e i relativi valori massimi associati. |
|
VT_UKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene nomi dei campi dati del sensore e i relativi valori minimi associati. |
|
VT_UKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene i nomi dei campi dei dati del sensore e le relative risoluzioni associate. I valori di risoluzione rappresentano la riservatezza per la modifica nel campo dati. I valori di risoluzione vengono espressi usando le stesse unità del campo dati, tranne se altrimenti documentate. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Numero di serie del sensore. |
|
VT_UI4 Sola lettura. Obbligatorio. Valore SensorState contenente lo stato corrente del sensore. |
|
VT_CLSID Sola lettura. Obbligatorio, statico. GUID che identifica il tipo di sensore. I tipi di sensore definiti dalla piattaforma sono definiti in Sensors.h. |
La proprietà Windows Portable Devices (WPD) seguente deve essere supportata da tutti i sensori.
| Chiave di proprietà | Descrizione |
|---|---|
|
VT_CLSID Sola lettura. Obbligatorio, statico. Definisce la categoria del sensore. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 7 [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
Vedi anche