enumeración GNSS_EVENT_TYPE (gnssdriver.h)

Esta enumeración indica el tipo de un evento y lo usa la estructura GNSS_EVENT.

El controlador GNSS utiliza eventos para enviar información solicitada y no solicitada al adaptador GNSS. Los eventos pueden producirse por diversos motivos, como una solicitud de controlador al adaptador GNSS para la inyección de datos de asistencia o con fines informativos.

Sintaxis

typedef enum {
  GNSS_Event_FixAvailable,
  GNSS_Event_RequireAgnss,
  GNSS_Event_Error,
  GNSS_Event_NiRequest,
  GNSS_Event_NmeaData,
  GNSS_Event_GeofenceAlertData,
  GNSS_Event_GeofencesTrackingStatus,
  GNSS_Event_DriverRequest,
  GNSS_Event_BreadcrumbAlertEvent,
  GNSS_Event_FixAvailable_2,
  GNSS_Event_Custom
} GNSS_EVENT_TYPE;

Constantes

GNSS_Event_FixAvailable Este evento se genera como resultado de una llamada de IOCTL_GNSS_GET_FIXDATA anterior desde el adaptador. El controlador GNSS genera este evento cuando hay una corrección disponible para que el adaptador lo recopile. Los datos de corrección se incluyen en los datos de evento en forma de GNSS_FIXDATA estructura.
GNSS_Event_RequireAgnss Este evento se genera como resultado de una llamada de IOCTL_GNSS_LISTEN_AGNSS anterior desde el adaptador. El controlador genera este evento siempre que necesite la inyección de determinados datos de asistencia de AGNSS. Los detalles de la inyección están disponibles en los datos del evento en forma de GNSS_AGNSS_REQUEST_PARAM estructura.
GNSS_Event_Error Este evento se genera como resultado de una llamada de IOCTL_GNSS_LISTEN_ERROR anterior desde el adaptador. El controlador genera este evento cuando se produce un error fuera de banda que el adaptador debe tener en cuenta. Los detalles del error están disponibles en los datos del evento en forma de GNSS_ERRORINFO estructura. Microsoft puede usar la información para capturar datos de telemetría sobre qué tipo de errores se ven en el campo por diferentes dispositivos, y los datos se pueden compartir con OEM/IHD para ayudar a comprender los problemas comunes y aumentar la calidad de las implementaciones del motor de GNSS.
GNSS_Event_NiRequest Este evento se genera cuando el controlador quiere notificar una solicitud de NI. HLOS procesará la solicitud (por ejemplo, mostrar un cuadro de diálogo si se solicita) y, a continuación, insertará una respuesta al controlador.
GNSS_Event_NmeaData Este evento se genera como resultado de una llamada a IOCTL_GNSS_LISTEN_NMEA anterior, si el registro nmEA está habilitado en el dispositivo. El controlador GNSS genera este evento cuando el cliente que realiza la llamada puede leer los datos de NMEA. Normalmente, el cliente que realiza la llamada será una herramienta de prueba. Los datos de oraciones de NMEA se incluyen en los datos del evento en forma de GNSS_NMEA_DATA estructura.
GNSS_Event_GeofenceAlertData Se ha infringido una geovalla creada anteriormente. En el momento de la creación de la geovalla, el HLOS había solicitado específicamente una alerta cuando se produce dicha infracción. Por ejemplo, no se debe generar una alerta para la entrada si HLOS solo ha solicitado alertas de salida.
GNSS_Event_GeofencesTrackingStatus El motor GNSS no puede realizar un seguimiento de una o varias geovallas debido a condiciones de señal incorrectas u otros problemas de posicionamiento. También se genera un estado cuando el motor GNSS se ha recuperado de una condición de error anterior y ahora puede realizar un seguimiento de todas las geovallas.
GNSS_Event_DriverRequest Reservado para futuras extensiones. El controlador GNSS solicita información fuera de banda de HLOS.
GNSS_Event_BreadcrumbAlertEvent Reservado para futuras extensiones: 0x0012-0x7FFF. Para cada nuevo tipo de evento, habrá un IOCTL bien definido que describa el proceso de inicio de este evento por el adaptador y una estructura de datos de eventos bien definida que describa los datos o comandos asociados a este evento.
GNSS_Event_FixAvailable_2 Los datos de corrección incluidos en los datos de evento de la estructura GNSS_FIXDATA_2.
GNSS_Event_Custom Reservado para acciones personalizadas específicas del proveedor: 0x8000 0xFFFF. El controlador GNSS genera este evento según sea necesario. El comando y los datos se empaquetan en un blob opaco como parte de los datos del evento. El paquete se envía al adaptador para serializar el componente auxiliar de GNSS.

Observaciones

Los eventos pueden ser de varios tipos. Algunos eventos se producen como resultado de una solicitud anterior iniciada por el controlador, por ejemplo, iniciar la solicitud de corrección. Se generan determinados eventos con fines informativos. Los eventos de asistencia se generan cuando el controlador requiere que el adaptador inserte datos de asistencia específicos.

Requisitos

Requisito	Valor
servidor mínimo admitido	Windows Server 2022
encabezado de	gnssdriver.h (incluya Gnssdriver.h)