Metodo ISensorDriver::OnGetDataFields (sensorclassextension.h)

Il metodo ISensorDriver::OnGetDataFields recupera i dati correnti del sensore.

Sintassi

HRESULT OnGetDataFields(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pDataFields,
  IPortableDeviceValues        **ppDataValues
);

Parametri

pClientFile

Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che richiede i dati.

pwszSensorID

LPWSTR contenente l'ID per il sensore da cui l'applicazione client richiede dati.

pDataFields

Puntatore a un oggetto IPortableDeviceKeyCollection che contiene l'elenco di valori PROPERTYKEY che rappresentano i campi dati richiesti.

ppDataValues

Indirizzo di un puntatore IPortableDeviceValues che riceve i dati richiesti.

Valore restituito

Questo metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a uno dei valori seguenti.

Commenti

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

Ogni oggetto IPortableDeviceValues restituito da questo metodo deve contenere un timestamp, come descritto in SENSOR_CATEGORY_ALL.

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

L'estensione della classe sensore chiama questo metodo solo per i sensori per i quali l'utente ha concesso l'autorizzazione tramite Pannello di controllo.

IPortableDeviceKeyCollection e IPortableDeviceValues sono documentati nei dispositivi portatili Windows.

Requisiti

Vedi anche

ISensorDriver