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 HRESULT. Entre los valores posibles se incluyen, entre otros, uno de los siguientes valores.
| código de retorno | descripción |
|---|---|
| S_OK | El método se realizó correctamente. |
| HRESULT_FROM_WIN32(ERROR_NO_DATA) | El sensor no tiene datos para informar. Cada uno de los campos de datos devueltos en el parámetro ppDataValues es VT_EMPTY. |
Observaciones
Los campos de datos contienen datos generados por sensores, 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 cualquier PROPVARIANT estructuras 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 del Panel de control.
IPortableDeviceKeyCollection y IPortableDeviceValues se documentan en Dispositivos portátiles windows.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | sensorsclassextension.h |
| biblioteca de | SensorsClassExtension.lib |