МБ подготовленные операции контекста
Подготовка жизненно важна для мобильных устройств, так как каждый мобильный оператор имеет разные конфигурации APN для своей сети. Конфигурации APN обычно можно разделить на две категории:
- Конфигурации APN, известные операционной системе, так как существуют приложения или клиенты над ОС, для которых требуются эти подключения.
- Конфигурации APN, которые не известны ОС, так как они внутренне используются модемом для подключений, которые не используются операционной системой и ее клиентами.
В идеале модем должен хранить только конфигурации APN, которые ос не должны знать. Тем не менее, партнеры IHV и OEM традиционно предоставили APN Интернета и покупки, конфигурации, известные ОС, в модеме, а также. До выпуска Windows 10 версии 1703 Windows считывает только конфигурации APN Интернета и покупки из модема для установления подключений к Интернету. Начиная с Windows 10 версии 1703, могут возникнуть дополнительные случаи, когда конфигурация APN модема должна управляться Windows, особенно если в ОС есть клиенты, такие как параметры пользователя или OMA-DM, которые хотят изменить конфигурацию сотовой связи. Это также может повлиять на конфигурацию APN модема. Например, в модеме может быть стек IMS, использующий APN IMS для SMS через IMS. Как правило, эти подключения не предоставляются операционной системе, но в некоторых сценариях может потребоваться изменить конфигурацию APN IMS. Это изменение можно сделать с помощью ОС. Для поддержки этого, начиная с Windows 10 версии 1703 ОС может настроить различные типы APN в модеме.
На usb-форуме МБ IM 1.0 и Microsoft NDIS каждый из них имеет существующий CID и OID соответственно, чтобы разрешить ОС устанавливать и запрашивать конфигурации APN в модеме. Для МБ IM 1.0 он делает это через МБ IM_CID_PROVISIONED_CONTEXT в то время как для NDIS он делает это через OID_WWAN_PROVISIONED_CONTEXTS. Однако существующий CID и OID не были разработаны с четким руководством по тому, как модем должен вести себя в различных ситуациях, таких как цикл питания или переключение SIM-карты. Устройства, которые хотят поддерживать настройку и обновление контекстов, подготовленных модемом, потребуется реализовать более новую версию CID и OID в Windows 10 версии 1703. Чтобы обеспечить обратную совместимость, для IHVs/OEM, которые хотят поддерживать новое оборудование в версиях ОС старше 1703, им придется продолжать поддерживать существующие МБ IM_CID_PROVISIONED_CONTEXT и OID_WWAN_PROVISIONED_CONTEXTS. Начиная с Windows 10 версии 1703, если устройство поддерживает новую версию CID и OID, ос будет использовать только более новую версию команды для запроса и настройки контекста APN в модеме.
обновление интерфейса МБ для подготовленных операций контекста
Хотя МБ IM имеет команду для получения и замены контекстов, хранящихся в модеме, оно не имеет поля для отключения или включения профиля. Поэтому для Windows 10 версии 1703 необходимо обновить существующие МБ IM_CID_PROVISIONED_CONTEXT, чтобы включить эту возможность. Так как МБ IM не имеет механизма управления версиями, новый собственный идентификатор CID MSFT определяется как МБ IM_CID_MS_PROVISIONED_CONTEXT_V2.
Имя службы = базовые расширения Подключение
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Значение UUID = 3d01dcc5-fef5-4d05-0d3abef70558e9aaf
| CID | Код команды | Minimum OS Version |
|---|---|---|
| МБ IM_CID_MS_PROVISIONED_CONTEXT_V2 | 1 | Windows 10 версии 1703 |
МБ IM_CID_MS_PROVISIONED_CONTEXT_V2
Description
Хотя МБ IM 1.0 определил МБ IM_CID_PROVISIONED_CONTEXT для ОС и его верхних клиентов для управления подготовленными контекстами в модеме, Windows традиционно запрашивает контекст в модеме, но не устанавливает его из ОС. Начиная с Windows 10 версии 1703, все больше требуется, чтобы ОС могла настраивать контексты в модеме. Например, если в модеме есть стек IMS, непрозрачный для ОС, ОС должна иметь возможность указать APN IMS, который должен использовать модем. Так как каждый модем IHV может иметь собственный собственный способ хранения контекстов в модеме, невозможно управлять профилями на уровне ContextId таким образом, как МБ IM_CID_PROVISIONED_CONTEXT может предложить. Вместо этого, с точки зрения ОС, более важно указать, какой контекст следует использовать для каждого типа контекста. Возвращаясь к примеру IMS независимо от того, сколько существующих подготовленных контекстов находятся в модеме, если ОС задает контекст, имеющий МБ IM_CONTEXT_TYPE = IMS, то все трафик IMS, инициированный модемом, должен быть предпринят только в этом контексте.
МБ IM 1.0 указывает, что МБ IM_CID_PROVISIONED_CONTEXT может вызывать запрос только в контекстах, которые соответствуют идентификатору поставщика (пара MCC/MNC) вставленного SIM-карта. Для запросов Set МБ IM_CID_PROVISIONED_CONTEXT может указать идентификатор поставщика контекста, который требуется сохранить. МБ IM_CID_MS_PROVISIONED_CONTEXT_V2 указывает аналогичное поведение, но отличается от МБ IM 1.0. Для каждого запроса ОС продолжает ожидать, что модем возвращает только контексты, соответствующие идентификатору поставщика вставленной SIM-карта. Для параметра Set команда больше не позволит ОС задать контексты, которые не соответствуют текущему идентификатору поставщика в SIM-карта. Ожидается, что запрос Set должен создать контекст для текущего идентификатора поставщика представленной SIM-карта. Например, пользователь переключается с SIM-1 на SIM 2, а затем возвращается к SIM 1. Ожидается, что во время первого переключения SIM модем должен разрешить все его контексты перед загрузкой контекста ДЛЯ SIM 2. Когда пользователь переключится на SIM 1, конфигурация по умолчанию sim 1 должна быть восстановлена. Для модема не ожидается сохранение конфигурации среды выполнения во время переключения SIM-карты.
На следующей схеме показан пример потока при переключении пользователя с одной SIM-карты на другую, а затем обратно на первую.
Изготовители оборудования и IHV, предварительно настроенные модемом, должны сохранять исходную конфигурацию фабрики в случае, если ОС или пользователь хочет восстановить параметры контекста в модеме до исходных параметров. Необходимо восстановить только исходные контексты фабрики для идентификатора поставщика SIM-карты, вставленного в данный момент. Исходные параметры фабрики, предварительно настроенные контексты, никогда не должны быть перезаписаны конфигурацией ОС. На следующей схеме представлен пример потока при выборе пользователем для восстановления параметров фабрики:
Ожидается, что для модема не удается выполнить запрос или задать запросы, если SIM-карта отсутствует, заблокирована или идентификатор поставщика недоступен. Модем должен иметь только один контекст на CONTEXT_TYPE на идентификатор поставщика. Если IHV или OEM решит предварительно настроить контексты модема в модеме, важно убедиться, что контексты настроены правильно для каждого поставщика, для которого он выбирает это. В случае, если вставленный SIM-карта не имеет предварительно настроенных контекстов IHV, модем не должен иметь никаких контекстов без настройки ОС. IHVs и OEM должны убедиться, что МБ IM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned, чтобы ОС будет использовать контекст модема для подключения, если он существует, и не перезаписывать его из базы данных APN Windows.
Как модем карты обрабатывают контекст и представляют его обратно через существующие МБ IM_CID_PROVISIONED_CONTEXT до каждого IHV и не область этой документации.
Новая команда МБ IM_CID_MS_PROVISONED_CONTEXT_V2 почти идентична существующей команде МБ IM 1.0 МБ IM_CID_PROVISIONED_CONTEXT, но с несколькими дополнениями. Первая предоставляет ОС возможность включения или отключения контекста, связанного с типом контекста в модеме. Если контекст отключен в модеме, модем, как ожидается, не будет использовать хранимый контекст для любого подключения к сети, даже те, которые не были осведомлены об ОС. Если ОС запрашивает подключение, соответствующее отключенной контексту в модеме, модем должен немедленно завершить запрос без сигнала в сеть. Процесс сопоставления должен соответствовать всем полям в структуре МБ IM_MS_CONTEXT_V2.
Структура МБ IM_CONTEXT_IP_TYPE из МБ IM 1.0 используется только для МБ IM_CID_CONNECT. В МБ IM_CID_MS_PROVISIONED_CONTEXT_V2 корпорация Майкрософт добавила тип IP-адреса в качестве одного из параметров для каждого контекста. Модем должен сообщать МБ IMContextIPTypeDefault, если он не настроен для данного контекста.
В Windows 10 версии 1703 с новым оборудованием, поддерживающим МБ IM_CID_MS_PROVISIONED_CONTEXT_V2, устаревшие МБ IM_CID_PROVISIONED_CONTEXT не будут использоваться из сторонних компонентов. Если существуют другие устаревшие компоненты клиента или ОС, которые отправляют МБ IM_CID_PROVISIONED_CONTEXT, модем должен возвращать результаты, как и в версиях Windows 10 до Windows 10 версии 1703.
Query
МБ IM_MS_PROVISIONED_CONTEXTS_INFO возвращается из запроса и задания полных сообщений в InformationBuffer.
Для запроса InformationBuffer имеет значение NULL.
Set
Для set InformationBuffer содержит структуру МБ IM_MS_SET_PROVISIONED_CONTEXT_V2. В операции Set, так как каждый модем IHV может иметь собственные способы управления хранилищем контекста, ОС больше не задает поле ContextId и ожидает, что модем сопоставляет контексты с соответствующим слотом. Если контексты ОС заданы, он ожидает, что модем будет использовать его для всех подключений, соответствующих МБ IM_CONTEXT_TYPE заданного контекста. Если МБ IM_CONTEXT_TYPE не распознается модемом, он по-прежнему должен хранить его, даже если он не может подключиться к нему.
Незапрошенное событие
Event InformationBuffer содержит структуру МБ IM_MS_PROVISIONED_CONTEXTS_INFO_V2. В некоторых случаях список подготовленных контекстов обновляется сетью либо по протоколу Over-The-Air (OTA), либо с помощью службы коротких сообщений (SMS), которая не выполняет команду МБ IM_CID_MS_PROVISIONED_CONTEXT_V2 из ОС. Функция должна обновить список подготовленных контекстов и тегов МБ IM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned соответствующим образом. После этого функции должны уведомить узел об обновлениях с помощью этого события с обновленным списком.
Параметры
| Операция | Set | Query | Notification |
|---|---|---|---|
| Команда | МБ IM_SET_MS_PROVISIONED_CONTEXT_V2 | Неприменимо | Неприменимо |
| Response | МБ IM_MS_PROVISIONED_CONTEXT_INFO_V2 | МБ IM_MS_PROVISIONED_CONTEXT_INFO_V2 | МБ IM_MS_PROVISIONED_CONTEXT_INFO_V2 |
структуры данных
Query
InformationBuffer должен иметь значение NULL, а InformationBufferLength — ноль.
Set
Следующая МБ IM_SET_MS_PROVISIONED_CONTEXT_V2 структура данных должна использоваться в InformationBuffer.
| Смещение | Размер | Поле | Тип | Описание |
|---|---|---|---|---|
| 0 | 4 | Операция | МБ IM_MS_CONTEXT_OPERATIONS | Указывает тип операции, для которой используется команда SET. Если задано значение MbimMsContextOperationDelete, необходимо удалить контекст указанного МБ IM_CONTEXT_TYPES, а все остальные поля в МБ IM_SET_MS_PROVISIONED_CONTEXT_V2 следует игнорировать. Если задано значение MbimMsContextOperationRestoreFactory, все созданные ос или измененные контексты должны быть удалены, необходимо загрузить предварительно настроенные контексты фабрики по умолчанию, а все остальные поля в МБ IM_SET_MS_PROVISIONED_CONTEXT_V2 следует игнорировать. |
| 4 | 16 | ContextType | МБ IM_CONTEXT_TYPES | Указывает тип представленного контекста; например, подключение к Интернету, VPN (подключение к корпоративной сети) или голосовой связи через IP (VOIP). Дополнительные сведения см. в таблице МБ IM_CONTEXT_TYPES. |
| 20 | 4 | IPType | МБ IM_CONTEXT_IP_TYPES | Указывает тип представленного контекста; например, подключение к Интернету, VPN (подключение к корпоративной сети) или голосовой связи через IP (VOIP). Дополнительные сведения см. в таблице МБ IM_CONTEXT_IP_TYPES. |
| 24 | 4 | Включить | МБ IM_MS_CONTEXT_ENABLE | Указывает, может ли контекст использоваться модемом. Если для него задано значение MbimMsContextDisabled, то любой запрос на подключение ОС, соответствующий контексту, должен завершиться сбоем без сигнала в сеть. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_ENABLE. |
| 28 | 4 | Роуминг | МБ IM_MS_CONTEXT_ROAMING_CONTROL | Указывает, разрешено ли перемещение для этого контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_ROAMING_CONTROL. |
| 32 | 4 | MediaType | МБ IM_MS_CONTEXT_MEDIA_TYPE | Указывает, какой тип транспорта мультимедиа используется для контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_MEDIA_TYPE. |
| 36 | 4 | Исходный код | МБ IM_MS_CONTEXT_SOURCE | Указывает источник создания контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_SOURCE. |
| 40 | 4 | AccessStringOffset | OFFSET | Смещение в буфере данных в строку AccessString для доступа к сети. Для сетей на основе GSM это будет строка имени точки доступа (APN), например "data.thephone-company.com". Для сетей на основе CDMA это может быть специальный код набора, например "#777" или идентификатор сетевого доступа (NAI), например "foo@thephone-company.com". Этот член может иметь значение NULL, чтобы запросить, чтобы сеть назначила APN по умолчанию. Примечание. Не все сети поддерживают это соглашение APN NULL, поэтому сбой подключения, вызванный недопустимым APN, является возможным результатом. Размер строки не должен превышать 100 символов. |
| 44 | 4 | AccessStringSize | SIZE(0.200) | Размер, используемый для AccessString. |
| 48 | 4 | UserNameOffset | OFFSET | Смещение в байтах, вычисленное с начала этой структуры, в строку UserName, представляющую имя пользователя для проверки подлинности. Этот элемент может иметь значение NULL. |
| 52 | 4 | UserNameSize | SIZE(0.510) | Размер, используемый для userName. |
| 56 | 4 | PasswordOffset | OFFSET | Смещение в байтах, вычисляемое с начала этой структуры, в строку, пароль, представляющую пароль имени пользователя. Этот элемент может иметь значение NULL. |
| 60 | 4 | PasswordSize | SIZE(0.510) | Размер, используемый для пароля. |
| 64 | 4 | Сжатие | МБ IM_COMPRESSION | Указывает сжатие, используемое в подключении к данным для заголовка и данных. Этот член применяется только к устройствам на основе GSM. Узел задает этому элементу значение МБ IMCompressionNone для устройств на основе CDMA. Дополнительные сведения см. в таблице МБ IM_COMPRESSION. |
| 68 | 4 | AuthProtocol | МБ IM_AUTH_PROTOCOL | Тип проверки подлинности, используемый для активации PDP. Дополнительные сведения см. в таблице МБ IM_AUTH_PROTOCOL. |
| 72 | 4 | DataBuffer | DATABUFFER | Буфер данных, содержащий AccessString, UserName и Password. |
В предыдущей таблице используются следующие структуры данных.
МБ IM_MS_CONTEXT_ROAMING_CONTROL указывает политику перемещения по контексту. ОС может указать, можно ли включить заданный контекст во время перемещения или нет. Модем не должен самостоятельно активировать контекст без вмешательства ОС, если состояние роуминга не соответствует указанным условиям. В случаях, когда модем не поддерживает партнеров, все конфигурации партнеров должны рассматриваться как эквивалентные домашним.
| Тип | значение | Описание |
|---|---|---|
| MbimMsContextRoamingControlHomeOnly | 0 | Указывает, разрешено ли использовать контекст только в домашней сети. |
| MbimMsContextRoamingControlPartnerOnly | 1 | Указывает, разрешено ли использовать контекст только в роуминговых сетях партнера. |
| MbimMsContextRoamingControlNonPartnerOnly | 2 | Указывает, разрешено ли использовать контекст только в перемещаемых сетях, не являющихся партнерами. |
| MbimMsContextRoamingControlHomeAndPartner | 3 | Указывает, разрешено ли использовать контекст в домашних и партнерских роуминговых сетях. |
| MbimMsContextRoamingControlHomeAndNonPartner | 4 | Указывает, разрешено ли использовать контекст в домашних и не партнерских роуминговых сетях. |
| MbimMsContextRoamingControlPartnerAndNonPartner | 5 | Указывает, разрешено ли использовать контекст в сетях роуминга партнера и не партнера. |
| MbimMsContextRoamingControlAllowAll | 6 | Указывает, разрешено ли использовать контекст в любом перемещаемом состоянии. |
МБ IM_MS_CONTEXT_MEDIA_TYPE добавлен, чтобы указать, используется ли контекст для сотовой связи или iWLAN при отключении Wi-Fi в будущих платформах. Например, если контекст задан как сотовый, и модем в настоящее время выгружает Wi-Fi, он не должен инициировать подключение с помощью этого контекста.
| Тип | значение | Описание |
|---|---|---|
| MbimMsContextMediaTypeCellularOnly | 0 | Указывает, разрешено ли использовать контекст только при регистрации на сотовой связи. |
| MbimMsContextMediaTypeWifiOnly | 1 | Указывает, разрешено ли использовать контекст только при регистрации в iWLAN (разгрузка Wi-Fi). |
| MbimMsContextMediaTypeAll | 2 | Указывает, разрешено ли использовать контекст при регистрации с помощью сотовой связи или Wi-Fi. |
МБ IM_MS_CONTEXT_ENABLE указывает, включен или отключен контекст.
| Тип | значение | Описание |
|---|---|---|
| MbimMsContextDisabled | 0 | Подготовленный контекст отключен. Модем не должен включать активацию в этом контексте из операционной системы и самого себя. |
| MbimMsContextEnabled | 1 | Включен подготовленный контекст. Контекст можно включить, если выполняются другие условия; Например, если роуминг запрещен, контекст не должен быть включен во время роуминга. |
МБ IM_MS_CONTEXT_SOURCE добавлен, чтобы обеспечить видимость ОС о том, как был создан контекст модема. Это помогает ОС правильно вести себя после различных ситуаций, таких как сброс фабрики, поэтому он может знать, что следует сохранять и что следует возвращать в состояние по умолчанию на основе различных требований оператора.
| Тип | значение | Описание |
|---|---|---|
| MbimMsContextSource Администратор | 0 | Контекст был создан ИТ-администратором предприятия из ОС. |
| MbimMsContextSourceUser | 1 | Контекст был создан пользователем с помощью параметров ОС. |
| MbimMsContextSourceOperator | 2 | Контекст был создан оператором через OMA-DM или другие каналы. |
| MbimMsContextSourceModem | 3 | Контекст был создан IHV или OEM, который был включен в встроенное ПО модема. |
| MbimMsContextSourceDevice | 4 | Контекст был создан базой данных APN ОС. |
МБ IM_MS_CONTEXT_OPERATIONS указывает операции, которые ос может выполнять для настройки контекстов в модеме.
| Тип | значение | Описание |
|---|---|---|
| MbimMsContextOperationDefault | 0 | Операция по умолчанию, включая добавление или замена существующего контекста в модеме. |
| MbimMsContextOperationDelete | 1 | Операция удаления требует, чтобы модем удалил существующий контекст в модеме. |
| MbimMsContextOperationRestoreFactory | 2 | Восстановите предварительно настроенный контекст фабрики для идентификатора поставщика вставляемой в данный момент SIM-карты. Все контексты, замененные или созданные ОС, должны быть удалены и заменены. Если для текущего вставленного идентификатора поставщика SIM-карт отсутствует контекст операционной системы по умолчанию, необходимо удалить подготовленный контекст в модеме. |
Исходный МБ IM_CONTEXT_TYPES из МБ IM 1.0 по-прежнему действителен. Корпорация Майкрософт добавляет дополнительные типы контекстов, так как были добавлены дополнительные типы контекстов, так как был определен МБ IM 1.0. В следующей таблице определены новые типы. IHVs и OEM могут определять другие собственные типы контекста с другими уникальными значениями UUID, которые не будут распознаваться ОС в своих собственных целях.
| Тип | значение | Описание |
|---|---|---|
| МБ IMMsContextType Администратор | 5f7e4c2e-e80b-40a9-a239-f0abcfd11f4b | Контекст используется для административных целей, таких как управление устройствами. |
| МБ IMMSContextTypeApp | 74d88a3d-dfbd-4799-9a8c-7310a37bb2ee | Контекст используется для определенных приложений, разрешенных мобильными операторами. |
| МБ IMMsContextTypeXcap | 50d378a7-baa5-4a50-b872-3fe5bb463411 | Контекст используется для подготовки XCAP в службах IMS. |
| МБ IMMsContextTypeTethering | 5e4e0601-48dc-4e2b-acb8-08b4016bbaac | Контекст используется для подключения мобильных хот-точек. |
| МБ IMMsContextTypeEmergencyCalling | 5f41adb8-204e-4d31-9da8-b3c970e360f2 | Контекст используется для экстренного вызова IMS. |
Response
Следующая МБ IM_MS_PROVISIONED_CONTEXT_INFO_V2 структура должна использоваться в InformationBuffer.
| Смещение | Размер | Поле | Тип | Описание |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | Количество МБ IM_MS_CONTEXT_V2 структур, которые следуют в DataBuffer. |
| 4 | 8 * EC | MsProvisionedContextV2RefList | OL_PAIR_LIST | Первым элементом пары является 4 байтовое смещение в байтах, вычисляемое с начала (смещение 0) этой структуры МБ IM_MS_PROVISIONED_CONTEXTS_INFO_V2, до структуры МБ IM_MS_CONTEXT_V2 (дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_V2). Второй элемент пары — это 4-байтовый размер указателя на соответствующую МБ IM_MS_CONTEXT_V2 структуру. |
| 4 + 8 * EC | DataBuffer | DATABUFFER | Массив структур МБ IM_MS_CONTEXT_V2. |
МБ IM_MS_CONTEXT_V2, используемый в предыдущей таблице, предоставляет сведения о заданном контексте.
| Смещение | Размер | Поле | Тип | Описание |
|---|---|---|---|---|
| 0 | 4 | ContextId | UINT32 | Уникальный идентификатор этого контекста. |
| 4 | 16 | ContextType | МБ IM_CONTEXT_TYPES | Указывает тип представленного контекста; например, подключение к Интернету, VPN (подключение к корпоративной сети) или голосовой связи через IP (VOIP). Устройства должны указывать МБ IMContextTypeNone для пустых или не подготовленных контекстов. Дополнительные сведения см. в таблице МБ IM_CONTEXT_TYPES. |
| 20 | 4 | IPType | МБ IM_CONTEXT_IP_TYPES | Дополнительные сведения см. в таблице МБ IM_CONTEXT_IP_TYPES. |
| 24 | 4 | Включить | МБ IM_MS_CONTEXT_ENABLE | Указывает, может ли контекст использоваться модемом. Если для него задано значение MbimMsContextDisabled, то любой запрос на подключение ОС, соответствующий контексту, должен завершиться сбоем без сигнала в сеть. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_ENABLE. |
| 28 | 4 | Роуминг | МБ IM_MS_CONTEXT_ROAMING_CONTROL | Указывает, разрешено ли перемещение для этого контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_ROAMING_CONTROL. |
| 32 | 4 | MediaType | МБ IM_MS_CONTEXT_MEDIA_TYPE | Указывает, какой тип транспорта мультимедиа используется для контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_MEDIA_TYPE. |
| 36 | 4 | Исходный код | МБ IM_MS_CONTEXT_SOURCE | Указывает источник создания контекста. Дополнительные сведения см. в таблице МБ IM_MS_CONTEXT_SOURCE. |
| 40 | 4 | AccessStringOffset | OFFSET | Смещение в буфере данных в строку AccessString для доступа к сети. Для сетей на основе GSM это будет строка имени точки доступа (APN), например "data.thephone-company.com". Для сетей на основе CDMA это может быть специальный код набора, например "#777" или идентификатор сетевого доступа (NAI), например "foo@thephone-company.com". Этот член может иметь значение NULL, чтобы запросить, чтобы сеть назначила APN по умолчанию. Примечание. Не все сети поддерживают это соглашение APN NULL, поэтому сбой подключения, вызванный недопустимым APN, является возможным результатом. Размер строки не должен превышать 100 символов. |
| 44 | 4 | AccessStringSize | SIZE(0.200) | Размер, используемый для AccessString. |
| 48 | 4 | UserNameOffset | OFFSET | Смещение в байтах, вычисленное с начала этой структуры, в строку UserName, представляющую имя пользователя для проверки подлинности. Этот элемент может иметь значение NULL. |
| 52 | 4 | UserNameSize | SIZE(0.510) | Размер, используемый для userName. |
| 56 | 4 | PasswordOffset | OFFSET | Смещение в байтах, вычисляемое с начала этой структуры, в строку, пароль, представляющую пароль имени пользователя. Этот элемент может иметь значение NULL. |
| 60 | 4 | PasswordSize | SIZE(0.510) | Размер, используемый для пароля. |
| 64 | 4 | Сжатие | МБ IM_COMPRESSION | Указывает сжатие, используемое в подключении к данным для заголовка и данных. Этот член применяется только к устройствам на основе GSM. Узел задает этому элементу значение МБ IMCompressionNone для устройств на основе CDMA. Дополнительные сведения см. в таблице МБ IM_COMPRESSION. |
| 68 | 4 | AuthProtocol | МБ IM_AUTH_PROTOCOL | Тип проверки подлинности, используемый для активации PDP. Дополнительные сведения см. в таблице МБ IM_AUTH_PROTOCOL. |
| 72 | DataBuffer | DATABUFFER | Буфер данных, содержащий AccessString, UserName и Password. |
Notification
Дополнительные сведения см. в таблице МБ IM_MS_PROVISIONED_CONTEXT_V2.
Коды состояний
Для операций запроса и задания:
| Код состояния | Description |
|---|---|
| МБ IM_STATUS_READ_FAILURE | Операция завершилась ошибкой, так как устройство не удалось получить подготовленные контексты. |
| МБ IM_STATUS_NO_DEVICE_SUPPORT | Сбой операции, так как устройство не поддерживает операцию. |
Только для операций Set:
| Код состояния | Description |
|---|---|
| МБ IM_STATUS_INVALID_PARAMETERS | Операция завершилась ошибкой из-за недопустимых параметров. |
| МБ IM_STATUS_WRITE_FAILURE | Операция завершилась ошибкой, так как запрос на обновление был неудачным. |
Инициализация устройств с подготовленным контекстом
Инициализация устройства, не заблокированного SIM-интерфейсом, с помощью подготовленного контекста
На следующей схеме представлен оптимальный пользовательский интерфейс для устройств на основе GSM МБ. Внестандартное взаимодействие не требует настройки пользователя. Предполагается, что устройство настроено для автоматического выбора сети для регистрации. Метки в полужирном виде представляют идентификаторы OID или элемент управления потоком транзакций. Метки в обычном тексте представляют важные флаги в структуре OID.
Чтобы инициализировать неблокируемое УСТРОЙСТВО НА ОСНОВЕ GSM, выполните следующие действия:
Служба МБ отправляет асинхронный OID_WWAN_READY_INFO (неблокирующий) запрос на запрос к минипорту драйверу, чтобы определить состояние готовности устройства. Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_READY_INFO службе МБ, которая указывает службе МБ, что состояние устройства МБ wwanReadyStateInitialized.
Служба МБ отправляет асинхронный OID_WWAN_REGISTER_STATE (неблокирующий) запрос на запрос к минипорту драйверу, чтобы определить состояние регистрации устройства. Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_REGISTER_STATE в службу МБ, указывающую, что режим регистрации устройства — WwanRegistraterModeAutomatic, а текущее состояние регистрации — WwanRegisterStateSearching.
Позже, когда устройство зарегистрировано в сетевом поставщике, драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_REGISTER_STATE в службу МБ, указывающую, что текущее состояние регистрации устройства — WwanRegisterStateHome.
Устройство пытается подключить службу пакетов. При изменении состояния службы пакетов в присоединенном драйвере минипорта отправляется незапрошенное NDIS_STATUS_WWAN_PACKET_SERVICE уведомление в службу МБ, указывающее, что служба пакетов подключена, а текущий класс данных WWAN_DATA_CLASS_GPRS.
Служба МБ отправляет асинхронный OID_WWAN_HOME_PROVIDER (неблокирующий) запрос на запрос к драйверу минипорта для получения сведений о поставщике дома. Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), который получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_HOME_PROVIDER службе МБ, указывающей сведения о поставщике дома.
Служба МБ отправляет асинхронный (неблокирующий) запрос OID_WWAN_PROVISIONED_CONTEXTS драйверу минипорта, чтобы получить список подготовленных контекстов. Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS службе МБ, содержащей список структур WWAN_CONTEXT.
Служба МБ отправляет асинхронный (неблокирующий) OID_WWAN_CONNECT задать запрос на минипорт драйвер для активации контекста протокола ДАННЫХ пакетов (PDP). Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет уведомление NDIS_STATUS_WWAN_CONTEXT_STATE службе МБ, указывающее, что контекст PDP активируется.
Драйвер минипорта отправляет уведомление NDIS_STATUS_LINK_STATE, чтобы указать, что состояние подключения мультимедиа — Media Подключение State Подключение ed.
Инициализация устройства пакета CDMA с подготовленным контекстом
На следующей схеме показан оптимальный пользовательский интерфейс для устройств на основе CDMA. Внестандартное взаимодействие не требует настройки пользователя. В этом сценарии предполагается, что учетная запись на основе CDMA не активирована. В отличие от устройств на основе GSM, устройство на основе CDMA автоматически начинает регистрацию в сети после завершения активации. Метки полужирным шрифтом — это идентификаторы OID или управление потоком транзакций. Метки в обычном тексте являются важными флагами в структуре OID.
Чтобы инициализировать устройство пакета на основе CDMA с подготовленным контекстом, выполните следующие действия:
Служба МБ отправляет асинхронные (неблокирующие) OID_WWAN_READY_INFO на минипорт-драйвер. Минипорт-драйвер отвечает с предварительным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и что он отправит уведомление с запрошенной информацией в будущем.
Минипорт-драйвер отправляет NDIS_STATUS_WWAN_FAILURE в службу МБ.
Служба МБ отправляет асинхронные (неблокирующие) OID_WWAN_SERVICE_ACTIVATION на минипорт-драйвер. Минипорт-драйвер отвечает с предварительным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и что он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_SUCCESS в службу МБ.
Минипорт-драйвер отправляет NDIS_STATUS_WWAN_REGISTER_STATE в службу МБ.
Минипорт-драйвер отправляет NDIS_STATUS_WWAN_REGISTER_STATE в службу МБ.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_PACKET_SERVICE в службу МБ.
Служба МБ отправляет асинхронные (неблокирующие) OID_WWAN_HOME_PROVIDER в минипорт-драйвер. Минипорт-драйвер отвечает с предварительным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и что он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_SUCCESS в службу МБ.
Служба МБ отправляет асинхронные (неблокирующие) OID_WWAN_PROVISIONED_CONTEXTS мини-драйверу. Минипорт-драйвер отвечает с предварительным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), которое он получил запрос, и что он отправит уведомление с запрошенными сведениями в будущем.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_SUCCESS в службу МБ.
Служба МБ отправляет асинхронные (неблокирующие) OID_WWAN_PROVISIONED_CONTEXTS мини-драйверу. Минипорт-драйвер отвечает с временным подтверждением (NDIS_STATUS_INDICATION_REQUIRED), что он получил запрос, и он отправит уведомление с запрошенной информацией в будущем.
Драйвер минипорта отправляет NDIS_STATUS_WWAN_SUCCESS в службу МБ.
Минипорт-драйвер отправляет NDIS_STATUS_LINK_STATE в службу МБ.