IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (driver.h)

Article
02/07/2025

Le code de contrôle IOCTL_GNSS_MODIFY_FIXSESSION est utilisé par l’adaptateur GRID pour modifier les paramètres de session de correction d’une session de correction active. Cela n’est nécessaire que lorsque le pilote PSEC ne prend pas en charge plusieurs sessions de correction du même type de correctif, par exemple lorsque la fonctionnalité SupportMultipleFixSession du pilote est FALSE.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Pointeur vers une structure GNSS_FIXSESSION_PARAM.

Longueur de la mémoire tampon d’entrée

Défini sur sizeof(GNSS_FIXSESSION_PARAM).

Mémoire tampon de sortie

Défini sur NULL.

Longueur de la mémoire tampon de sortie

Défini sur 0.

Bloc d’état

> IoStatus.Status est défini sur STATUS_SUCCESS si la requête réussit. Sinon, état à la condition d’erreur appropriée en tant que code NTSTATUS.

Remarques

Le pilote définit une valeur NTSTATUS pour indiquer l’un des résultats suivants.

La session de correction a été correctement modifiée.
La session de correctif est actuellement arrêtée ou non active.
Impossible de modifier le paramètre de session de correction.

notes de l’adaptateur DIMENSIONNELLE

L’adaptateur EAP utilise ce IOCTL pour modifier les paramètres de session de correction d’une session de correction active pour prendre en charge les nouvelles demandes de correction des applications LBS.

Si l’appel échoue, l’adaptateur SSH ne multiplexe pas la nouvelle demande de correctif dans la session active existante. Au lieu de cela, il continuera à s’attendre à ce que la session de correctif active reste inchangée.

Si l’appel réussit, l’adaptateur SSH s’attend à ce que les données de correction suivantes respectent les paramètres de session nouvellement spécifiés.

notes de pilote PSEC

Si la prise en charge de plusieurs sessions n’est pas présente, le pilote PSEC doit prendre en charge ce IOCTL et modifier les paramètres de session de correction à la volée pour la session active.

Une fois que le pilote PSEC accepte les paramètres de session de correction, les valide et les envoie au moteur UO, il doit immédiatement terminer la demande d’E/S avec un code de retour réussi.

Une fois l’exécution réussie, le pilote PSEC doit retourner toutes les données de correction en fonction des nouveaux paramètres de session de correction. Toutefois, les données de correction qui sont déjà fournies à l’adaptateur SEE doivent toujours être mises à disposition et ne doivent pas être ignorées.