OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS считывает или обновляет подготовленные записи контекста, хранящиеся на устройстве МБ или модуле удостоверения подписчика (SIM).
Драйверы минипорта должны обрабатывать и запрашивать запросы асинхронно, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправлять уведомление о состоянии NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS, содержащее структуру NDIS_WWAN_PROVISIONED_CONTEXTS, чтобы предоставить сведения о подготовленных записях контекста, хранящихся на устройстве МБ или модуле удостоверений подписчика (SIM), независимо от завершения набора или запроса.
Замечания
Дополнительные сведения об использовании этого OID см. в управления контекстом пакетов WWAN.
Мини-порты должны возвращать NDIS_STATUS_NOT_SUPPORTED, если устройство, которое они поддерживают, не поддерживает получение подготовленных контекстов.
Устройства на основе GSM могут при необходимости поддерживать операции запроса и установки. Устройства на основе CDMA могут при необходимости поддерживать операции создания отчетов об простом IP-адресе (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
Подготовленные записи контекста, хранящиеся на устройстве в МБ, или SIM-карта являются локальными для устройства. Мини-порты не должны подключаться к сети для чтения в этих полях.
Входная структура для запроса набора NDIS_WWAN_SET_PROVISIONED_CONTEXT и указание состояния этого объекта NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Подготовленные контексты не совпадают с определениями контекста JSON в 3GPP, который кэширует список APN. Подготовленные контексты — это параметры подключения (AccessString, UserName и Пароль), которые предварительно подготовлены операторами или OTA, подготовленными устройством, и могут храниться в памяти устройства или SIM-карте. Параметры подключения, возвращаемые подготовленными контекстами, будут использоваться службой MB для активации PDP.
Используется как запрос, так и форма задания этого объекта.
Для обработки этого запроса не требуется сетевой доступ, но требуется доступ к SIM-карте или вспомогательной памяти на устройстве МБ.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS уведомления операционной системе. Элемент ContextListHeader.ElementType должен иметь значение WwanStructContext. Драйвер минипорта должен задать элемент ContextListHeader.ElementCount значение 0 при отправке уведомления в ответ на заданный запрос.
Служба МБ должна получить список подготовленных контекстов с устройства, прежде чем проводить активацию или деактивацию любого отдельного контекста. Список подготовленных контекстов должен быть ограничен только сетью поставщика дома, даже если устройство может иметь возможность хранить несколько контекстов поставщика сети. Список контекстов всегда должен быть сетевым поставщиком дома, даже в случае роуминга.
Операция SET OID_WWAN_PROVISIONED_CONTEXT должна связать контекст с сетевым поставщиком, указанным в запросе набора в ProviderId члена структуры WWAN_SET_CONTEXT. Подготовленный контекст, хранящийся с помощью набора OID_WWAN_PROVISIONED_CONTEXT запросов, должен сохраняться во время перезагрузки системы и перезапуска питания устройства.
Все пустые контексты необходимо сообщать о запросе вместе с подготовленными контекстами, применимыми к сети поставщика дома.
Устройства CDMA, настроенные для SimpleIP, отчеты в WWAN_CTRL_CAPS_CDMA_SIMPLE_IP в WwanControlCaps могут при необходимости возвращать по крайней мере один подготовленный контекст, заполненный правильным AccessString, UserNameи паролем членов запроса из службы MB.
Подготовленный список контекстов должен быть предварительно подготовлен на устройстве, обновлен путем установки OID_WWAN_PROVISIONED_CONTEXT операций или обновления устройства или оператора с помощью SMS или OTA. Он не должен обновляться динамически на основе сведений о контексте, предоставленных в операции OID_WWAN_CONNECT службой МБ.
Дополнительные сведения о том, как получить доступ к AccessString, UserName и Password с устройства МБ для каждого подготовленного контекста в списке, см. в WWAN_CONTEXT.
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (include Ndis.h) |