IOCTL_GNSS_LISTEN_NI IOCTL (gnssdriver.h)

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 用戶端必須視需要負責安裝/使用憑證。

必要條件

   
標頭 gnssdriver.h

另請參閱

在驅動程式中建立 IOCTL 要求

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously