IOCTL_GNSS_LISTEN_NI IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_LISTEN_NI Steuercode wird verwendet, um mit dem Lauschen auf eine SUPL-NI-Anforderung zu beginnen.

Diese IOCTL stellt dem GNSS-Treiber effektiv eine ausstehende E/A-Anforderung bereit, mit der er die NI-Anforderung über das überlappende GnssEvent-Element an den Adapter übermitteln kann. Das GnssEvent-Element ist eine GNSS_EVENT-Struktur . Der Adapter stellt sicher, dass diese Anforderung immer aussteht, und gibt eine neue Anforderung aus, sobald die ausstehende anforderung aufgelöst wurde. Wenn die E/A-Anforderung aufgelöst wird, gibt der Adapter eine entsprechende IOCTL_GNSS_RESPOND_NI aus.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Auf NULL festgelegt.

Länge des Eingabepuffers

Auf 0 festlegen.

Ausgabepuffer

Auf NULL festgelegt.

Länge des Ausgabepuffers

Auf 0 festlegen.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Der EventType muss auf GNSS_Event_NI festgelegt und der NiRequest-Member ausgefüllt werden.

Hinweise zum GNSS-Adapter

Der GNSS-Adapter stellt sicher, dass diese Anforderung immer aussteht, sodass der Treiber angeben kann, dass eine NI-Anforderung vorliegt.

Wenn der Treiber den E/A-Aufruf abschließt, gibt der Adapter eine andere IOCTL aus, um weiterhin auf weitere NI-Anforderungen zu warten. Der Adapter sollte die IOCTL sofort ausgeben, auch wenn die vorherigen NI-Anforderungen aufgrund von Benutzerinteraktionen angehalten werden.

Hinweise zu GNSS-Treibern

Wenn der GNSS-Treiber eine NI-Anforderung vom SUPL/CP erhält, schließt er den E/A-Vorgang ab.

Diese Zertifikate, die vom Mobilfunkanbieter angegeben und über den SUPL-Konfigurationsdienstanbieter konfiguriert werden, werden benötigt, um eine Verbindung mit dem H-SLP oder E-SLP herzustellen. Der GNSS-Adapter pusht nur die SUPL-Konfiguration, einschließlich der zertifikatierten, an den GNSS-Treiber. Die Zertifikate werden nicht im Windows-Dateisystem installiert. Dies liegt daran, dass verschiedene IHVs möglicherweise unterschiedliche Implementierungen des SUPL-Clients haben, und einige können die Implementierung ihres eigenen TLS-Stapels enthalten. Der GNSS-Adapter ist unabhängig von allen Implementierungsdetails des SUPL-Clients. Der GNSS-Treiber kann die Zertifikate in der Registrierung oder auf dem Datenträger speichern oder sie basierend auf ihrer Verwendung direkt an den SUPL-Client pushen. Der SUPL-Client muss die Zertifikate nach Bedarf installieren/verwenden.