IOCTL_GNSS_LISTEN_NI IOCTL (gnssdriver.h)

發行項
02/26/2024

IOCTL_GNSS_LISTEN_NI控件程式代碼可用來開始接聽 SUPL NI 要求。

此 IOCTL 有效地為 GNSS 驅動程式提供擱置的 I/O 要求，可透過重疊的結構 GnssEvent 成員，將 NI 要求傳達給配接器。 GnssEvent 成員是 GNSS_EVENT 結構。配接器可確保此要求一律擱置，並在解決暫止要求時立即發出新的要求。當 I/O 要求解決時，配接器會發出對應的 IOCTL_GNSS_RESPOND_NI。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

設定為 NULL。

輸入緩衝區長度

設定為 0。

輸出緩衝區

設定為 NULL。

輸出緩衝區長度

設定為 0。

狀態區塊

Irp->如果要求成功，IoStatus.Status 會設定為 STATUS_SUCCESS。否則，狀態為適當的錯誤狀況為 NTSTATUS 程式碼。

備註

EventType 必須設定為 GNSS_Event_NI，並填入 NiRequest 成員。

GNSS 配接器附註

GNSS 配接器可確保此要求一律擱置中，讓驅動程式可以指出有 NI 要求。

當驅動程式完成 I/O 呼叫時，配接器會發出另一個 IOCTL 以繼續等候進一步的 NI 要求。配接器應該立即發出 IOCTL，即使先前的 NI 要求因為用戶互動而保留。

GNSS 驅動程式注意事項

每當 GNSS 驅動程式從 SUPL/CP 取得 NI 要求時，就會完成 I/O 作業。

若要建立與 H-SLP 或 E-SLP 的連線，需要由電信業者所指定的憑證，並透過 SUPL 設定服務提供者進行設定。 GNSS 配接器只會將 SUPL 設定，包括憑證式推送至 GNSS 驅動程式。它不會在 Windows 檔案系統中安裝憑證。這是因為不同的 IHV 可能會有不同的 SUPL 用戶端實作，有些則可能包含自己的 TLS 堆疊實作。 GNSS 配接器與 SUPL 用戶端的任何實作詳細數據無關。 GNSS 驅動程式可以將憑證儲存在登錄或磁碟中，或根據其使用量直接推送至 SUPL 用戶端。 SUPL 用戶端必須視需要負責安裝/使用憑證。