IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)

Articolo
02/07/2025

Il codice di controllo IOCTL_GNSS_CONFIG_SUPL_CERT viene usato dall'adattatore GNSS per impostare i certificati SUPL.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Puntatore a una struttura GNSS_SUPL_CERT_CONFIG.

Lunghezza del buffer di input

Impostare su sizeof(GNSS_SUPL_CERT_CONFIG).

Buffer di output

Impostare su NULL.

Lunghezza del buffer di output

Impostare su 0.

Blocco di stato

Irp-> IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, stato alla condizione di errore appropriata come codice NTSTATUS.

Osservazioni

Il driver imposta uno dei valori NTSTATUS seguenti per indicare il risultato.

STATUS_SUCCESS, quando il driver elabora correttamente le informazioni sul certificato SUPL. Se IOCTL tenta di eliminare o eliminare i certificati che non esistono, restituisce comunque STATUS_SUCCESS.
Operazione non riuscita, quando il driver non elabora correttamente le informazioni sul certificato SUPL.
Ignorato, quando il driver ignora le informazioni sul certificato SUPL.

Note sulla scheda GNSS

Per GNSS DDI versione 1:

L'adattatore GNSS non deve eseguire alcuna operazione speciale.

Per GNSS DDI versione 2 e successive:

L'adapter GNSS farà riferimento solo ai certificati in base al nome. Il driver GNSS eseguirà il mapping interno dei nomi dei certificati a qualsiasi altra rappresentazione o riferimento ai certificati, se necessario.

L'adattatore GNSS eseguirà un'eliminazione completa o tutti i certificati inseriti in precedenza, se necessario, prima di inserire un nuovo set.

note sul driver GNSS

Il driver GNSS deve passare queste informazioni sul certificato al componente SUPL che deve usare il certificato per configurare la connessione sicura con H-SLP.

Per GNSS DDI versione 2 e successive:

Il driver GNSS deve supportare la ricezione di più chiamate del IOCTL_GNSS_CONFIG_SUPL_CERT. L'adattatore GNSS chiamerà questo IOCTL più volte, ogni volta per inserire un certificato radice diverso. I certificati radice diversi vengono identificati con un diversoSuplCertName , che fornisce il nome del certificato inserito.

Se il nome corrisponde a un certificato configurato in precedenza, il certificato verrà sostituito.
Se il nome è diverso dal certificato, verrà aggiunto il nuovo certificato.

Se viene nuovamente inserito un certificato con lo stesso nome di un certificato esistente, il driver GNSS deve sovrascrivere il certificato precedente con lo stesso nome.