Metodo ISensorDriver::OnSetProperties (sensorsclassextension.h)

Articolo
02/07/2025

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 che contiene l'ID del 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 IPortableDeviceValues puntatore che riceve l'elenco delle proprietà impostate correttamente e i relativi 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.

Osservazioni

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 del 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 in Dispositivi portatili Windows.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7,Disponibile in Windows 7.
server minimo supportato	Nessuna supportata
piattaforma di destinazione	Desktop
intestazione	sensorsclassextension.h
libreria	SensorsClassExtension.lib

Vedere anche

ISensorDriver

ISensorDriver::OnGetProperties

Condividi tramite