Metodo ISensorDriver::OnSetProperties (sensorclassextension.h)

Articolo
02/29/2024

Il metodo ISensorDriver::OnSetProperties specifica i valori per l'elenco specificato di proprietà.

Sintassi

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

Parametri

[in] pClientFile

Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che specifica i valori delle proprietà.

[in] pwszSensorID

LPWSTR contenente l'ID per il sensore per il quale l'applicazione client specifica i valori delle proprietà.

[in] pPropertiesToSet

Puntatore a un'interfaccia IPortableDeviceValues che contiene l'elenco di proprietà da impostare e i relativi valori.

[out] ppResults

Indirizzo di un puntatore IPortableDeviceValues che riceve l'elenco delle proprietà impostate correttamente e dei nuovi valori. Se una proprietà non è stata impostata, il nuovo valore contiene un codice di errore HRESULT.

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.

L'elenco delle proprietà fornite tramite pPropertiesToSet è in genere un subset dell'elenco restituito tramite ISensorDriver::OnGetSupportedProperties. Tuttavia, l'estensione della classe sensore non applica questa condizione alle applicazioni client.

L'estensione della classe del sensore è responsabile della liberazione di qualsiasi struttura PROPVARIANT restituita da questo metodo.

IPortableDeviceValues è documentato nei dispositivi portatili Windows.

Nota Questo metodo verrà chiamato solo se l'utente ha abilitato il sensore nel pannello di controllo Location e Other Sensor .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7,Disponibile in Windows 7.
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Desktop
Intestazione	sensorclassextension.h
Libreria	SensorsClassExtension.lib

Vedi anche

ISensorDriver

ISensorDriver::OnGetProperties

Condividi tramite