IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)
GNSS 配接器會使用 IOCTL_GNSS_CONFIG_SUPL_CERT 控件程式代碼來設定 SUPL 憑證。
主要程序代碼
輸入緩衝區
GNSS_SUPL_CERT_CONFIG 結構的指標。
輸入緩衝區長度
設定為sizeof (GNSS_SUPL_CERT_CONFIG) 。
輸出緩衝區
設定為 NULL。
輸出緩衝區長度
設定為 0。
狀態區塊
Irp->如果要求成功，IoStatus.Status 會設定為 STATUS_SUCCESS。 否則， 狀態 為適當的錯誤狀況為 NTSTATUS 程式碼。
備註
驅動程式會設定下列其中一個NTSTATUS值來指出結果。
- STATUS_SUCCESS，當驅動程式成功處理 SUPL 憑證資訊時。 如果 IOCTL 嘗試刪除或清除不存在的憑證，它仍會傳回STATUS_SUCCESS。
- 失敗，當驅動程式未成功處理 SUPL 憑證資訊時。
- 當驅動程式忽略 SUPL 憑證資訊時，會忽略。
GNSS 配接器附註
針對 GNSS DDI 第 1 版：GNSS 配接器不需要執行任何特殊動作。
針對 GNSS DDI 第 2 版和更新版本：
GNSS 配接器只會依名稱參考憑證。 GNSS 驅動程式最多會視需要將憑證名稱對應至任何其他表示法或憑證參考。
GNSS 配接器會在插入新集合之前，視需要執行完整清除或所有先前插入的憑證。
GNSS 驅動程式注意事項
GNSS 驅動程式必須將此憑證資訊傳遞至 SUPL 元件，該元件應該使用憑證來設定與 H-SLP 的安全連線。針對 GNSS DDI 第 2 版和更新版本：
GNSS 驅動程式必須支援接收 IOCTL_GNSS_CONFIG_SUPL_CERT的多個呼叫。 每次插入不同的跟證書時，GNSS 配接器都會多次呼叫此 IOCTL。 使用不同的 SuplCertName 來識別不同的跟證書，這會提供所插入憑證的名稱。
- 如果名稱與先前設定的憑證相同，則會取代憑證。
- 如果名稱與憑證不同，則會新增新的憑證。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | gnssdriver.h |
另請參閱
WdfIoTargetSendInternalIoctlOthersSynchronously