énumération GNSS_EVENT_TYPE (driver.h)

Cette énumération indique le type d’un événement et est utilisée par la structure GNSS_EVENT.

Le pilote PSEC utilise des événements pour envoyer des informations sollicitées et non sollicitées à l’adaptateur PSEC. Les événements peuvent se produire pour diverses raisons, telles qu’une demande de pilote à l’adaptateur PSEC pour l’injection de données d’assistance ou à des fins d’information.

Syntaxe

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
Cet événement est déclenché suite à un appel de IOCTL_GNSS_GET_FIXDATA antérieur à partir de l’adaptateur. Le pilote PSEC déclenche cet événement lorsqu’un correctif est disponible pour la collecte de l’adaptateur. Les données de correctif sont incluses dans les données d’événement sous forme de structure GNSS_FIXDATA.
GNSS_Event_RequireAgnss
Cet événement est déclenché suite à un appel de IOCTL_GNSS_LISTEN_AGNSS antérieur à partir de l’adaptateur. Le pilote déclenche cet événement chaque fois qu’il a besoin d’injection de certaines données d’assistance APSEC. Les spécificités de l’injection sont disponibles dans les données d’événement sous forme de structure GNSS_AGNSS_REQUEST_PARAM.
GNSS_Event_Error
Cet événement est déclenché suite à un appel de IOCTL_GNSS_LISTEN_ERROR antérieur à partir de l’adaptateur. Le pilote déclenche cet événement lorsqu’une erreur hors bande se produit que l’adaptateur doit être informé. Les détails de l’erreur sont disponibles dans les données d’événement sous forme de structure GNSS_ERRORINFO. Les informations peuvent être utilisées par Microsoft pour capturer des données de télémétrie sur le type d’erreurs visibles dans le champ par différents appareils, et les données peuvent être partagées avec des OEM/IHV pour mieux comprendre les problèmes courants et améliorer la qualité des implémentations du moteur SEE.
GNSS_Event_NiRequest
Cet événement est déclenché lorsque le pilote souhaite notifier une demande NI. Le HLOS traite la requête (par exemple, affiche une boîte de dialogue si elle est demandée), puis injecte une réponse au pilote.
GNSS_Event_NmeaData
Cet événement est déclenché suite à un appel de IOCTL_GNSS_LISTEN_NMEA antérieur, si la journalisation NMEA est activée sur l’appareil. Le pilote RTC déclenche cet événement lorsque les données NMEA sont prêtes à être lues par le client appelant. Le client appelant est généralement un outil de test. Les données des phrases NMEA sont incluses dans les données d’événement sous forme de structure GNSS_NMEA_DATA.
GNSS_Event_GeofenceAlertData
Une limite géographique créée précédemment a été violée. Au moment de la création de la limite géographique, le HLOS avait spécifiquement demandé une alerte lorsqu’une telle violation se produit. Par exemple, une alerte d’entrée ne doit pas être déclenchée si le HLOS a demandé uniquement des alertes de sortie.
GNSS_Event_GeofencesTrackingStatus
Le moteur INTEROPÉRABILITÉ ne peut pas suivre une ou plusieurs limites géographiques en raison de conditions de signal incorrectes ou d’autres problèmes de positionnement. Un état est également déclenché lorsque le moteur SAUVEGARDÉE a récupéré à partir d’une condition d’échec précédente et est maintenant en mesure de suivre toutes les limites géographiques.
GNSS_Event_DriverRequest
Réservé à une extension ultérieure.

Le pilote PSEC demande des informations hors bande à la HLOS.
GNSS_Event_BreadcrumbAlertEvent
Réservé à une extension ultérieure : 0x0012-0x7FFF.

Pour chaque nouveau type d’événement, il y aura un IOCTL bien défini décrivant le processus d’initiation de cet événement par l’adaptateur et une structure de données d’événement bien définie décrivant les données/commandes associées à cet événement.
GNSS_Event_FixAvailable_2
Données de correction incluses dans les données d’événement dans la structure GNSS_FIXDATA_2.
GNSS_Event_Custom
Réservé aux actions personnalisées spécifiques au fournisseur : 0x8000-0xFFFF.

Le pilote PSEC déclenche cet événement en fonction des besoins. La commande et les données sont empaquetées dans un objet blob opaque dans le cadre des données d’événement. Le package est envoyé à l’adaptateur pour le marshaling vers le composant d’assistance BACKGROUND.

Remarques

Les événements peuvent être de différents types. Certains événements se produisent à la suite d’une demande précédente lancée par le pilote, par exemple, démarrer la demande de correction. Certains événements sont déclenchés à des fins d’information. Les événements d’assistance sont déclenchés lorsque le pilote exige que l’adaptateur injecte des données d’assistance spécifiques.

Exigences

Exigence Valeur
serveur minimum pris en charge Windows Server 2022
d’en-tête driver.h (include Messagedriver.h)
  • Last updated on