Informazioni sulle costanti dei sensori

La piattaforma Sensore e posizione di Windows usa costanti in molti modi. La piattaforma definisce costanti diverse che è possibile usare nel codice del driver del sensore. I produttori di sensori possono definire costanti personalizzate. È possibile trovare le definizioni delle costanti definite dalla piattaforma nel file Sensors.h. Per informazioni dettagliate sulle costanti dei sensori definite dalla piattaforma, vedere Costanti.

Organizzazione di sensori e dati

La piattaforma organizza sensori e dati nei modi seguenti.

• Le categorie rappresentano classi ampie di dispositivi sensore. Le categorie consentono di raggruppare i sensori che probabilmente forniscono tipi di informazioni simili o sono altrimenti correlati in qualche modo. Ogni categoria è rappresentata da una costante GUID . Ad esempio, i sensori che segnalano le coordinate di latitudine e longitudine appartengono alla categoria del sensore di posizione. Ciò è rappresentato dalla costante SENSOR_CATEGORY_LOCATION.
• I tipi di sensori rappresentano tipi specifici di sensori. Ogni tipo di sensore rientra in una categoria specifica. Due sensori di tipi diversi possono appartenere alla stessa categoria o a categorie diverse. Ogni tipo di sensore è rappresentato da una costante GUID . Ad esempio, un sensore di sistema di posizionamento globale viene identificato dalla costante SENSOR_TYPE_LOCATION_GPS. Tuttavia, un sensore che fornisce la posizione corrente usando un indirizzo IP verrebbe identificato dalla costante SENSOR_TYPE_LOCATION_LOOKUP. Tuttavia, entrambi i sensori appartengono alla categoria del sensore di posizione.
• I tipi di dati rappresentano tipi specifici di informazioni che il sensore può fornire. I tipi di dati del sensore possono contenere il valore di misurazione effettivo, ad esempio l'altitudine; informazioni sulle unità utilizzate per esprimere i dati, ad esempio i contatori; e punti di riferimento per i dati, ad esempio il livello del mare. Ogni tipo di dati è rappresentato da una costante PROPERTYKEY . Ad esempio, il tipo di dati che rappresenta l'altitudine sopra il livello del mare, in metri, verrebbe identificato dalla costante SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Quando si segnalano dati, si dice che un valore sia contenuto in un campo dati e una raccolta di campi dati correlati costituisce un report dati. I report dati vengono inseriti in un pacchetto usando l'interfaccia IPortableDeviceValues . Ogni report dati deve contenere almeno un campo dati valido e un timestamp che identifica quando è stato creato il report dati. I timestamp sono rappresentati dalla costante SENSOR_DATA_TYPE_TIMESTAMP.

Altre costanti

Il programma deve usare anche altre costanti. Queste costanti includono quanto segue:

• Proprietà del sensore, ad esempio SENSOR_PROPERTY_DESCRIPTION. In genere, queste costanti vengono usate per descrivere un sensore. Alcune proprietà del sensore devono essere fornite dal sensore, alcune proprietà possono essere impostate dalle applicazioni client e alcune devono sempre restituire lo stesso valore dal sensore. La sezione informazioni di riferimento sulle proprietà del sensore fornisce queste informazioni per ogni proprietà.
• Costanti degli eventi, ad esempio SENSOR_EVENT_STATE_CHANGED. Le costanti evento includono GUID, che rappresentano i tipi di eventi e PROPERTYKEYs, che rappresentano i tipi di parametri di evento. Queste costanti verranno usate per le chiamate ai metodi, ad esempio ISensor::SetEventInterest e ISensor::GetEventInterest.

Costanti personalizzate

I produttori di sensori possono definire costanti personalizzate. Ad esempio, un sensore può appartenere a una categoria non definita dalla piattaforma. Prima di poter usare un sensore che definisce costanti personalizzate, il produttore del sensore deve pubblicare i valori, ad esempio pubblicando un file di intestazione. Per altre informazioni, vedere la documentazione fornita con il sensore.