IOCTL_GNSS_SEND_PLATFORM_CAPABILITY IOCTL (gnssdriver.h)

Articolo
02/07/2025

Il codice di controllo IOCTL_GNSS_SEND_PLATFORM_CAPABILITY viene usato dall'adattatore GNSS per comunicare le varie funzionalità della piattaforma specifiche della posizione. Il driver GNSS può usare questi dati in vari modi. Ad esempio, se la piattaforma non supporta l'inserimento di dati di assistenza, il driver GNSS può usare la rete operativa mobile per cercare tali informazioni. L'uso delle singole informazioni sulle funzionalità è facoltativo e il driver può ignorare le informazioni sulle funzionalità della piattaforma per il relativo funzionamento.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Puntatore a una struttura GNSS_PLATFORM_CAPABILITY.

Lunghezza del buffer di input

Impostare su sizeof(GNSS_PLATFORM_CAPABILITY).

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 sulle funzionalità.
Non riuscito, quando il driver non elabora correttamente le informazioni sulle funzionalità.
Ignorato, quando il driver ignora le informazioni sulle funzionalità.

Note sulla scheda GNSS

Si tratta di una chiamata di tipo fire-and-forget void al conducente. L'adattatore GNSS non esegue alcuna gestione speciale degli errori anche quando la chiamata ha esito negativo.

note sul driver GNSS

Il driver può registrare le informazioni sulle funzionalità nelle variabili di stato e passare al motore in base alle esigenze. L'I/O deve essere completato non appena le informazioni di configurazione verranno copiate.

Questa operazione deve essere chiamata quando l'adattatore GNSS inizializza il driver GNSS.