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. Le definizioni delle costanti definite dalla piattaforma sono disponibili nel file Sensors.h. Per informazioni dettagliate sulle costanti del sensore definite dalla piattaforma, vedere costanti .

Organizzazione di sensori e dati

La piattaforma organizza sensori e dati nei modi seguenti.

• Le categorie rappresentano classi generali di dispositivi sensore. Le categorie consentono di raggruppare i sensori che sono probabilmente in grado di fornire tipi simili di informazioni 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. Questo valore è rappresentato dalla costante SENSOR_CATEGORY_LOCATION.
• I tipi di sensori rappresentano tipi specifici di sensori. Ogni tipo di sensore rientra in una determinata categoria. 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 al livello del mare, in metri, verrebbe identificato dalla costante SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
• Quando si segnalano i 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 dei dati vengono raggruppati 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 restituire sempre lo stesso valore dal sensore. La sezione di riferimento proprietà del sensore fornisce queste informazioni per ogni proprietà.
• Costanti evento, ad esempio SENSOR_EVENT_STATE_CHANGED. Le costanti di evento includono GUIDs, che rappresentano 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.