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 值之一来指示结果。
- 当驱动程序成功处理 SUPL 证书信息时，STATUS_SUCCESS。 如果 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 来标识的，该名称提供要注入的证书的名称。
- 如果名称与以前配置的证书相同，则将替换该证书。
- 如果名称与证书不同，则将添加新证书。
要求
| 要求 | 值 |
|---|---|
| Header | gnssdriver.h |
另请参阅
WdfIoTargetSendInternalIoctlOthersSynchronously