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

El método ISensorDriver::OnGetDataFields recupera los datos actuales del sensor.

Sintaxis

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

Parámetros

pClientFile

Puntero a una interfaz IWDFFile que representa el objeto de archivo para la aplicación que solicita los datos.

pwszSensorID

LPWSTR que contiene el identificador del sensor desde el que la aplicación cliente solicita datos.

pDataFields

Puntero a un IPortableDeviceKeyCollection que contiene la lista de valores PROPERTYKEY que representan los campos de datos que se solicitan.

ppDataValues

Dirección de un puntero IPortableDeviceValues que recibe los datos solicitados.

Valor devuelto

Este método devuelve un VALOR HRESULT. Entre los valores posibles se incluyen, entre otros, uno de los siguientes valores.

Comentarios

Los campos de datos contienen datos generados por el sensor, en lugar de propiedades, que describen el dispositivo del sensor. Los campos de datos definidos por la plataforma se definen en sensors.h.

Cada objeto IPortableDeviceValues devuelto por este método debe contener una marca de tiempo, como se describe en SENSOR_CATEGORY_ALL.

La extensión de clase sensor es responsable de liberar las estructuras PROPVARIANT devueltas por este método.

La extensión de clase sensor llama a este método solo para los sensores para los que el usuario ha concedido permiso a través de Panel de control.

IPortableDeviceKeyCollection e IPortableDeviceValues se documentan en Dispositivos portátiles windows.

Requisitos

Consulte también

ISensorDriver