Compartir a través de


Método ISensor::GetData (sensorsapi.h)

Recupera el informe de datos de sensor más reciente.

Sintaxis

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

Parámetros

[out] ppDataReport

Dirección de un puntero ISensorDataReport que recibe el puntero al informe de datos del sensor más reciente.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
El controlador del sensor proporcionó datos con un formato incorrecto. Por ejemplo, los datos eran de un tipo que no se admite. Para obtener información sobre los tipos de datos de campos de datos definidos por la plataforma, vea Categorías de sensor, Tipos y Campos de datos.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
El sensor no tiene datos para informar. Por ejemplo, un sensor GPS podría estar en proceso de adquirir una corrección por satélite.
E_POINTER
Null se pasó para ppDataReport.

Comentarios

En el caso de los sensores de ubicación, solo puede recuperar datos de los sensores para los que el usuario ha concedido permiso.

Este método puede devolver datos antes de que el controlador haya establecido el estado en SENSOR_STATE_READY.

Ejemplos

Para obtener un ejemplo de cómo recuperar datos del sensor, consulte Recuperación de valores de datos del sensor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado sensorsapi.h
Library Sensorsapi.lib
Archivo DLL Sensorsapi.dll

Consulte también

ISensor

Administración de permisos de usuario

RequestPermissions

Categorías, tipos y campos de datos del sensor