Compartir a través de


Umbrales de magnetómetro

En este tema se proporciona información sobre los umbrales del magnetómetro.

En la tabla siguiente se muestran los valores de umbrales disponibles para el magnetómetro. Para obtener más información sobre los tipos que se muestran en la columna de tipo, vea la estructura PROPVARIANT.

Clave de propiedad Tipo Obligatorio/opcional Valor predeterminado Descripción
PKEY_SensorData_MagneticFieldStrengthX_Microteslas VT_R4 Requerido 5.0f Cantidad mínima de cambio de campo magnético a lo largo del eje X necesario para alcanzar el umbral, medido en microteslas.
PKEY_SensorData_MagneticFieldStrengthY_Microteslas VT_R4 Requerido 5.0f Cantidad mínima de cambio de campo magnético a lo largo del eje Y necesario para alcanzar el umbral, medido en microteslas.
PKEY_SensorData_MagneticFieldStrengthZ_Microteslas VT_R4 Requerido 5.0f Cantidad mínima de cambio de campo magnético a lo largo del eje z necesario para alcanzar el umbral, medido en microteslas.

Los controladores magnetómetros deben notificar una lectura de ejemplo a la extensión de clase sensors llamando a SensorsCxSensorDataReady cuando se cumplen los umbrales de PKEY_SensorData_MagneticFieldStrengthX_Microteslas, PKEY_SensorData_MagneticFieldStrengthY_Microteslas o PKEY_SensorData_MagneticFieldStrengthZ_Microteslas. Cada umbral debe medirse por eje. Por lo tanto, los controladores deben llamar a SensorsCxSensorDataReady siempre que se cumpla la condición de umbral en cualquiera de los ejes. Cuando PKEY_SensorData_MagneticFieldStrengthX_Microteslas, o PKEY_SensorData_MagneticFieldStrengthY_Microteslas, o PKEY_SensorData_MagneticFieldStrengthZ_Microteslas se establece en 0,0f, el controlador debe notificar lecturas de ejemplo a la extensión de clase sensors en cada intervalo. Este modo se conoce como streaming de ejemplo de sensor.

Los controladores magnetómetros siempre deben notificar una lectura de ejemplo inmediatamente después de que la extensión de clase sensors llame a la devolución de llamada EvtSensorStart independientemente de los valores de umbral. Este ejemplo se conoce como lectura inicial de ejemplo.