IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)

Статья
08/07/2023

Код элемента управления IOCTL_GNSS_CONFIG_SUPL_CERT используется адаптером GNSS для задания сертификатов SUPL.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Указатель на структуру GNSS_SUPL_CERT_CONFIG .

Длина входного буфера

Задайте для параметра sizeof(GNSS_SUPL_CERT_CONFIG).

Выходной буфер

Задайте значение NULL.

Длина выходного буфера

Задайте значение 0.

Блок состояния

Irp->IoStatus.Status имеет значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае — состояние соответствующего условия ошибки в виде кода 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, который предоставляет имя внедряемого сертификата.

Если имя совпадает с ранее настроенным сертификатом, сертификат будет заменен.
Если имя отличается от имени сертификата, будет добавлен новый сертификат.

Если сертификат с тем же именем, что и существующий сертификат, внедряется снова, драйвер GNSS должен перезаписать предыдущий сертификат тем же именем.