Método ISensorDriver::OnGetDataFields (sensorsclassextension.h)

O método ISensorDriver::OnGetDataFields recupera os dados atuais do sensor.

Sintaxe

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

Parâmetros

pClientFile

Ponteiro para uma interface IWDFFile que representa o objeto de arquivo para o aplicativo que solicita os dados.

pwszSensorID

LPWSTR que contém a ID do sensor do qual o aplicativo cliente está solicitando dados.

pDataFields

Ponteiro para um IPortableDeviceKeyCollection que contém a lista de valores PROPERTYKEY que representam os campos de dados que estão sendo solicitados.

ppDataValues

Endereço de um ponteiro IPortableDeviceValues que recebe os dados solicitados.

Retornar valor

Esse método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, um dos valores a seguir.

Comentários

Os campos de dados contêm dados gerados por sensor, em vez de propriedades, que descrevem o dispositivo de sensor. Os campos de dados definidos pela plataforma são definidos em sensors.h.

Cada objeto IPortableDeviceValues retornado por esse método deve conter um carimbo de data/hora, conforme descrito em SENSOR_CATEGORY_ALL.

A extensão da classe de sensor é responsável por liberar quaisquer estruturas PROPVARIANT retornadas por esse método.

A extensão de classe de sensor chama esse método apenas para sensores para os quais o usuário concedeu permissão por meio de Painel de Controle.

IPortableDeviceKeyCollection e IPortableDeviceValues estão documentados em Dispositivos Portáteis do Windows.

Requisitos

Confira também

ISensorDriver