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