estructura GNSS_GEOFENCE_CREATE_PARAM (gnssdriver.h)

La estructura GNSS_GEOFENCE_CREATE_PARAM define los parámetros para crear una geovalla en el motor GNSS.

Sintaxis

typedef struct {
  ULONG               Size;
  ULONG               Version;
  ULONG               AlertTypes;
  GNSS_GEOFENCE_STATE InitialState;
  GNSS_GEOREGION      Boundary;
  BYTE                Unused[512];
} GNSS_GEOFENCE_CREATE_PARAM, *PGNSS_GEOFENCE_CREATE_PARAM;

Miembros

Size

Tamaño de la estructura.

Version

Número de versión.

AlertTypes

Se trata de una máscara de bits que indica las distintas alertas de esta geovalla en la que está interesado HLOS. El motor de GNSS no debe generar ninguna alerta de geovalla a menos que el HLOS lo solicite específicamente.

Si el HLOS solo establece GNSS_GEOFENCEALERTTYPE_ENTRY, el motor de GNSS debe realizar un seguimiento de la geovalla todo el tiempo, pero generar alerta solo cuando el dispositivo haya entrado en la geovalla. Se espera la siguiente alerta cuando el dispositivo sale de la geovalla y vuelve a entrar.

Si el HLOS solo establece GNSS_GEOFENCEALERTTYPE_EXIT, el motor de GNSS debe realizar un seguimiento de la geovalla todo el tiempo, pero generar una alerta solo cuando el dispositivo salga de la geovalla después de introducirla anteriormente. Se espera la siguiente alerta cuando el dispositivo se mueve dentro de la geovalla y vuelve a salir.

Si HLOS establece las máscaras de bits, el motor de GNSS debe realizar un seguimiento de la geovalla todo el tiempo y generar una alerta a medida que el dispositivo se mueve hacia y fuera de la geovalla .

En todos los casos, el motor de GNSS debe generar por separado la alerta de estado de seguimiento global si no puede realizar el seguimiento de las geovallas (independientemente de su configuración de alerta).

InitialState

Indica el estado inicial de la geovalla específica, tal como ve HLOS. El motor GNSS debe usar este estado como estado inicial de la geovalla, en lugar de empezar siempre desde el estado GNSS_GeofenceState_Unknown. Esto permite que el motor de GNSS permanezca sincronizado con los HLOS en términos de los estados de geovalla y obtenga cualquier diferencia en la lógica de entrada o detección de salida de la geovalla entre el motor GNSS y HLOS.

A medida que el motor GNSS inicia el seguimiento de la geovalla recién agregada, si determina que la geovalla está en un estado diferente al de este estado inicial, debe generar la alerta adecuada. Por el contrario, si los estados son idénticos, no se debe generar ninguna alerta.

Boundary

Límite real de la geovalla.

Unused[512]

Búfer de relleno reservado para uso futuro.

Observaciones

Una forma geográfica se usa para definir una geovalla. Windows 10 actualmente solo admite geovallas circulares.

Requisitos

Requisito	Valor
encabezado de	gnssdriver.h (incluya Gnssdriver.h)