IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (ombadriver.h)

Article
02/07/2025

Le code de contrôle IOCTL_GNSS_CONFIG_SUPL_CERT est utilisé par l’adaptateur GRID pour définir des certificats SUPL.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Pointeur vers une structure GNSS_SUPL_CERT_CONFIG.

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

Défini sur sizeof(GNSS_SUPL_CERT_CONFIG).

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 l’une des valeurs NTSTATUS suivantes pour indiquer le résultat.

STATUS_SUCCESS, lorsque le pilote traite correctement les informations de certificat SUPL. Si le IOCTL tente de supprimer ou de vider des certificats qui n’existent pas, il retourne toujours STATUS_SUCCESS.
Échec, lorsque le pilote ne traite pas correctement les informations de certificat SUPL.
Ignoré, lorsque le pilote ignore les informations de certificat SUPL.

notes de l’adaptateur DIMENSIONNELLE

Pour DIMENSIONNELLE DDI version 1 :

L’adaptateur RUNTIME n’a pas besoin de faire quelque chose de spécial.

Pour DIMENSIONNELLE DDI version 2 et ultérieure :

L’adaptateur IRA fait uniquement référence aux certificats par nom. Il sera jusqu’au pilote PSEC pour mapper les noms de certificats en interne à toute autre représentation ou référence aux certificats, si nécessaire.

L’adaptateur PERSONNALISATION effectue une purge complète ou tous les certificats précédemment injectés si nécessaire avant d’injecter un nouvel ensemble.

notes de pilote PSEC

Le pilote PSEC doit transmettre ces informations de certificat au composant SUPL qui doit utiliser le certificat pour configurer la connexion sécurisée avec H-SLP.

Pour DIMENSIONNELLE DDI version 2 et ultérieure :

Le pilote RTC doit prendre en charge la réception de plusieurs appels du IOCTL_GNSS_CONFIG_SUPL_CERT. L’adaptateur EAP appelle cette IOCTL plusieurs fois, chaque fois pour injecter un certificat racine différent. Différents certificats racines sont identifiés en ayant un autre SuplCertName, qui fournit le nom du certificat en cours d’injection.

Si le nom est identique à un certificat précédemment configuré, le certificat est remplacé.
Si le nom est différent du certificat, le nouveau certificat est ajouté.

Si un certificat portant le même nom qu’un certificat existant est injecté à nouveau, le pilote PSEC doit remplacer le certificat précédent portant le même nom.