Metodo ISensorDriver::OnGetProperties (sensorsclassextension.h)

Articolo
08/07/2023

Il metodo ISensorDriver::OnGetProperties recupera i valori per le proprietà specificate dal sensore specificato.

Sintassi

HRESULT OnGetProperties(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pProperties,
  IPortableDeviceValues        **ppPropertyValues
);

Parametri

pClientFile

Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che richiede valori di proprietà.

pwszSensorID

LPWSTR che contiene l'ID per il sensore da cui l'applicazione client richiede i valori delle proprietà.

pProperties

Puntatore a un oggetto IPortableDeviceKeyCollection che contiene l'elenco di valori PROPERTYKEY che rappresentano le proprietà richieste.

ppPropertyValues

Indirizzo di un puntatore IPortableDeviceValues che riceve i valori delle proprietà richieste.

Valore restituito

Se l'operazione ha esito positivo, questo metodo restituisce S_OK. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Commenti

Le proprietà descrivono il dispositivo sensore, anziché i campi dati, che contengono dati generati dal sensore. Le proprietà definite dalla piattaforma sono definite in sensors.h.

Le applicazioni possono accedere ad alcune informazioni sulle proprietà del sensore prima che l'utente conceda l'autorizzazione per il sensore. Questi elementi sono limitati agli ID seguenti definiti in sensors.h:

Qualsiasi PROPERTYKEY che inizia con "SENSOR_PROPERTY_".
Qualsiasi GUID di categoria che inizia con "SENSOR_CATEGORY_".

Ogni oggetto IPortableDeviceValues restituito in questa raccolta deve contenere valori per le proprietà necessarie, come descritto nella sezione di riferimento Sensor Properties .

L'estensione della classe del sensore è responsabile della liberazione di tutte le strutture PROPVARIANT restituite da questo metodo.

Le proprietà del sensore non devono contenere informazioni che possono essere usate per identificare l'utente. Per altre informazioni sulla privacy degli utenti, vedere Privacy e sicurezza in Sensor and Location Platform.For more information about user privacy, see Privacy and Security in the Sensor and Location Platform.

IPortableDeviceKeyCollection e IPortableDeviceValues sono documentati in Dispositivi portatili Windows.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	sensorsclassextension.h
Libreria	SensorsClassExtension.lib

Vedi anche

ISensorDriver

Condividi tramite