Condividi tramite


Requisiti generali per lo sviluppo di applicazioni (API sensore)

Questo argomento descrive le operazioni da eseguire per iniziare a creare programmi che usano l'API Sensore.

Per creare un'applicazione API Sensore, è necessario installare Windows 7 e Windows 7 Software Development Kit (SDK) nel computer. Nella tabella seguente vengono descritti i file specifici necessari.

Nome file Descrizione
Sensorsapi.h File di intestazione principale per l'API Sensor. Questo file di intestazione contiene le definizioni dell'interfaccia.
Sensors.h File di intestazione che contiene definizioni di costanti definite dalla piattaforma.
Initguid.h File di intestazione che contiene definizioni per controllare l'inizializzazione GUID .
FunctionDiscoveryKeys.h File di intestazione che definisce le chiavi delle proprietà ID dispositivo necessarie quando ci si connette ai sensori logici.
Sensorsapi.lib Libreria statica che contiene definizioni GUID per l'API Sensore.
PortableDeviceGuids.lib Libreria statica che contiene definizioni GUID per gli oggetti Dispositivi portatili Windows.

Il programma può richiedere file aggiuntivi.

Sistemi operativi supportati

Le applicazioni API sensore verranno eseguite in tutte le edizioni di Windows 7, ad eccezione dell'edizione Windows 7 Starter.

Interfacce dei dispositivi portatili Windows

L'API Sensore usa alcuni oggetti WPD (Windows Portable Devices) per incapsulare chiavi e valori delle proprietà. Nella tabella seguente vengono descritte le interfacce per questi oggetti.

Interfaccia Descrizione
IPortableDeviceValues Questa interfaccia offre un modo pratico per creare un contenitore di proprietà di coppie nome/valore. I nomi sono rappresentati da PROPERTYKEYs e i valori sono rappresentati da PROPVARIANTs.
L'API usa questa interfaccia per l'impostazione e il recupero di singoli valori e set di valori. Questa interfaccia può essere recuperata da un metodo o, se è necessario un nuovo oggetto, chiamando CoCreateInstance con CLSID_PortableDeviceValues.
IPortableDeviceKeyCollection Questa interfaccia contiene una raccolta di PROPRIETÀKEYs. Queste chiavi rappresentano i nomi delle proprietà che possono essere archiviati da IPortableDeviceValues. L'API usa questo oggetto raccolta per impostare e recuperare sia nomi di proprietà singole che set di nomi di proprietà.
Questa interfaccia può essere recuperata da un metodo o, se è necessario un nuovo oggetto, chiamando CoCreateInstance con CLSID_PortableDeviceKeyCollection.