IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)

Articolo
02/07/2025

Il codice di controllo IOCTL_GNSS_MODIFY_FIXSESSION viene usato dall'adattatore GNSS per modificare i parametri di sessione di correzione di una sessione di correzione attiva. Questa operazione è necessaria solo quando il driver GNSS non supporta più sessioni di correzione dello stesso tipo di correzione, ad esempio quando la funzionalità di SupportMultipleFixSession del driver è FALSE.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Puntatore a una struttura GNSS_FIXSESSION_PARAM.

Lunghezza del buffer di input

Impostare su sizeof(GNSS_FIXSESSION_PARAM).

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 un valore NTSTATUS per indicare uno dei risultati seguenti.

La sessione di correzione è stata modificata correttamente.
La sessione di correzione è attualmente arrestata o non attiva.
Impossibile modificare il parametro della sessione di correzione.

Note sulla scheda GNSS

L'adattatore GNSS usa questo IOCTL per modificare i parametri di sessione di correzione di una sessione di correzione attiva per supportare nuove richieste di correzione dalle applicazioni LBS.

Se la chiamata non riesce, l'adattatore GNSS non eseguirà il multiplex della nuova richiesta di correzione nella sessione attiva esistente. Continuerà invece a prevedere che la sessione di correzione attiva sia rimasta invariata.

Se la chiamata ha esito positivo, l'adapter GNSS prevede che i dati di correzione successivi rispettino i nuovi parametri di sessione specificati.

note sul driver GNSS

Se il supporto per più sessioni non è presente, il driver GNSS deve supportare questo IOCTL e modificare i parametri della sessione di correzione in tempo reale per la sessione attiva.

Dopo che il driver GNSS accetta i parametri di sessione di correzione, li convalida e li invia al motore GNSS, deve completare immediatamente la richiesta di I/O con un codice restituito con esito positivo.

Al termine, il driver GNSS deve restituire tutti i dati di correzione in base ai nuovi parametri di sessione di correzione. Tuttavia, correggere i dati già in corso durante il processo di messa a disposizione dell'adattatore GNSS devono comunque essere resi disponibili e non devono essere rimossi.