Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Usare invece l'API sensore UWP .
L'API del sensore basata su COM è deprecata e non deve essere usata nelle nuove applicazioni. Non sono pianificate funzionalità o miglioramenti aggiuntivi e il supporto sarà limitato.
La piattaforma Sensor e 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, se non diversamente specificato.
Ogni proprietà del sensore definita dalla piattaforma PROPERTYKEY si basa su un GUID comune denominato SENSOR_PROPERTY_COMMON_GUID:
{7F8383EC-D3EC-495C-A8CF-B8BBE85C2920}.
Importante
Non usare questo valore di base per definire chiavi di proprietà personalizzate.
I valori per le proprietà designate come lettura/scrittura possono essere specificati dall'applicazione client. I valori per le proprietà designate come statici non devono cambiare nel tempo. Le proprietà designate come necessarie devono essere supportate dal sensore.
| Nome chiave di proprietà e PID | Description |
|---|---|
|
VT_UNKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene i nomi dei tipi di dati del sensore e le relative accuratezze associate. I valori di accuratezza rappresentano la possibile variazione da valori true. I valori di accuratezza vengono espressi utilizzando le stesse unità del campo dati, tranne quando diversamente documentato. |
|
VT_UNKNOWN Lettura/scrittura. Oggetto IPortableDeviceValues che contiene i nomi dei tipi di dati del sensore e i relativi valori di riservatezza delle modifiche associati. Modificare i valori di riservatezza specificare le 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, tranne dove diversamente documentato. Per alcuni sensori, la sensibilità 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 sensibilità della modifica viene interpretata come percentuale. Pertanto, una modifica della sensibilità di 2 per SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX rappresenta più o meno 2% di LUX. È possibile impostare questo valore per richiedere una particolare riservatezza delle modifiche, ma più applicazioni potrebbero usare lo stesso sensore. Di conseguenza, i sensori determinano la vera sensibilità 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 di dispositivo reimposta SENSOR_PROPERTY_CHANGE_SENSITIVITY sul valore predefinito. |
|
VT_UI4 Sola lettura. Valore SensorConnectionType che contiene il tipo di connessione corrente. |
|
VT_UI4 Lettura/scrittura. Tempo trascorso corrente per la generazione del report dei dati del sensore, espresso in millisecondi. L'impostazione di un valore pari a zero indica 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 è consigliabile che più applicazioni usino lo stesso driver. Pertanto, i driver determinano l'intervallo di report reale, 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 degli eventi dell'API del sensore. |
|
VT_LPWSTR Sola lettura. Stringa di descrizione del sensore. |
|
VT_LPWSTR Sola lettura. Identifica in modo univoco l'istanza del dispositivo a cui è associato il sensore. È possibile utilizzare 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 del dispositivo. |
|
VT_UI4 Sola lettura. Questa proprietà viene fornita in modo che i produttori di sensori HID e gli sviluppatori di driver abbiano un mezzo per identificare un sensore che superfici nel livello API con un nome descrittivo "sconosciuto". |
|
VT_VECTOR|VT_UI1 Sola lettura. Matrice con conteggiata che contiene coppie di valori che forniscono un mapping tra i livelli di luce ambientale e gli offset. Questi valori sono espressi come percentuali. La funzionalità di luminosità adattiva in Windows applica questi valori alla preferenza di luminosità dello schermo corrente dell'utente. I dati per i tipi di vettore vengono sempre serializzati come VT_UI1 (matrice di caratteri senza segno, a 1 byte). Questa proprietà contiene effettivamente ogni valore come intero senza segno a 4 byte (VT_UI4).This property contains each value as a 4-byte unsigned integer (VT_UI4). Per informazioni sull'uso delle matrici, vedere Recupero di tipi di vettore. |
|
VT_UI4 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 energetico e altre considerazioni sui costi. LOCATION_DESIRED_ACCURACY_HIGH (1) indica che il sensore deve fornire il report più accurato possibile. Ciò include l'uso di servizi che potrebbero pagare denaro o consumare livelli più elevati di alimentazione della batteria o larghezza di banda di 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, espresso in millisecondi. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Nome del modello del 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 dati del sensore e i relativi valori massimi associati. |
|
VT_UKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene i nomi dei campi dati del sensore e i relativi valori minimi associati. |
|
VT_UKNOWN Sola lettura. Oggetto IPortableDeviceValues che contiene i nomi dei campi dati del sensore e le relative risoluzioni associate. I valori di risoluzione rappresentano la riservatezza da modificare nel campo dati. I valori di risoluzione vengono espressi utilizzando le stesse unità del campo dati, tranne quando diversamente documentato. |
|
VT_LPWSTR Sola lettura. Obbligatorio, statico. Numero di serie del sensore. |
|
VT_UI4 Sola lettura. Obbligatorio. Valore SensorState che contiene lo stato corrente del sensore. |
|
VT_CLSID Sola lettura. Obbligatorio, statico. GUID che identifica il tipo di sensore. I tipi di sensori definiti dalla piattaforma sono definiti in Sensors.h. |
La proprietà WPD (Windows Portable Devices) seguente deve essere supportata da tutti i sensori.
| Chiave della proprietà | Description |
|---|---|
|
VT_CLSID Sola lettura. Obbligatorio, statico. Definisce la categoria del sensore. |
Requisiti
| Requisito | Value |
|---|---|
| Client minimo supportato |
Windows 7 [solo app desktop] |
| Server minimo supportato |
Nessuna supportata |
| Header |
|