OID_WWAN_CONNECT
OID_WWAN_CONNECT активирует или деактивирует определенный контекст пакета и считывает состояние активации контекста.
Драйверы мини-порта должны асинхронно обрабатывать запросы set и query, первоначально возвращая NDIS_STATUS_INDICATION_REQUIRED в исходный запрос, а затем отправлять уведомление о состоянии NDIS_STATUS_WWAN_CONTEXT_STATE , содержащее NDIS_WWAN_CONTEXT_STATE структуру, которая указывает контекстное состояние протокола пакетных данных (PDP) устройства в МБ независимо от завершения набора или запросов.
Вызывающие абоненты, запрашивающие задать состояние контекста протокола пакетных данных (PDP) устройства в МБ, предоставляют драйверу мини-порта структуру NDIS_WWAN_SET_CONTEXT_STATE с соответствующими сведениями.
Комментарии
Дополнительные сведения об использовании этого объекта OID см. в разделе Управление контекстом пакетов WWAN.
Этот объект активирует или деактивирует определенный контекст пакета и считывает состояние активации контекста. Драйвер мини-порта должен отправлять соответствующие уведомления о событиях при каждом изменении состояния активации.
Этот объект вызывается, только если драйвер мини-порта находится в состоянии регистрации WwanRegisterStateHome, WwanRegisterStatePartner или WwanRegisterStateRoaming. Если служба пакетов активна, устройство также должно находиться в состоянии подключения WwanPacketServiceStateAttached.
Для этого объекта поддерживаются операции set и query.
Для обработки запроса набора требуется доступ к сети, но не доступ к SIM-карте.
Для обработки запроса не требуется доступ к сети или SIM-карте.
Структура данных для этого объекта OID NDIS_WWAN_SET_CONTEXT_STATE. Драйвер мини-порта выдает сведения о состоянии NDIS_STATUS_WWAN_CONTEXT_STATE как для запросов набора, так и для запросов.
В этой версии модели драйвера драйвер мини-порта пытается активировать контекст только в том случае, если указано службой MB. (Драйверы miniport могут активировать контекст, инициированный сетью в более поздних версиях.) Драйверы мини-порта не должны автоматически активировать контекст даже после потери регистрации или сигнала. Если строка доступа не указана в запросе на активацию, драйвер мини-порта не должен пытаться предоставить строку по умолчанию. Вместо этого необходимо активировать контекст с помощью пустой строки доступа.
С другой стороны, драйвер мини-порта может деактивировать контекст, как указано в службе MB. Это может произойти, когда сетевое подключение было потеряно в течение периода, превышающего пороговую величину временной потери сигнала, или в рамках корректного завершения работы или очистки состояния.
Так как в этой версии поддерживается только один активированный контекст, активация или деактивация определенного контекста равносильна настройке или удалению подключения уровня 2 МБ.
При заданных запросах служба MB предоставляет параметры ConnectionId и ActivationCommand в WWAN_CONTEXT_STATE структуре данных. Он предписывает драйверу мини-порта активировать или деактивировать контекст пакета, определяемый ConnectionId, на основе значения параметра ActivationCommandActivate или WwanActivationCommandDeactivate.
Если для службы или подписки требуется активация, драйвер мини-порта должен вернуть код ошибки WWAN_STATUS_SERVICE_NOT_ACTIVATED. Активация PDP может не выполняться до тех пор, пока служба или подписка не будут активированы. Все экстренные службы могут быть доступны при поддержке устройства и оператора. Операционная система может вызвать OID_WWAN_SERVICE_ACTIVATION в ответ на этот код ошибки.
Если драйвер мини-порта получает запрос на активацию контекста, а другой контекст пакета активирован в данный момент, он возвращает код ошибки WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.
Если драйвер мини-порта получает запрос на деактивацию контекста, но контекст, определенный ConnectionId , в настоящее время не активирован, он возвращает код ошибки WWAN_STATUS_CONTEXT_NOT_ACTIVATED.
Драйвер мини-порта использует следующую логику для определения допустимости параметров AccessString, UserName и Password из запроса набора:
- Если activationCommand имеет значение WwanActivationCommandDeactivate, драйвер мини-порта должен игнорировать параметры этих трех параметров. В остальных случаях рассматривается только случай, когда ActivationCommand имеет значение WwanActivationCommandActivate.
Контекстная активация сохраняется при входе и выходе пользователя. Это не для каждого пользователя, в который входит вход.
При запросах служба MB использует этот объект для поиска состояния активации.
Чтобы ответить на запросы, драйвер мини-порта отправляет NDIS_STATUS_WWAN_CONTEXT_STATE уведомление.
Важно Примечание:
В редких, но определенных обстоятельствах служба MB в Windows 7 может попытаться выполнить автоматическое подключение до того, как будет установлено подключение к Интернету для уже существующих подключений или во время кратковременного нарушения подключения к Интернету для существующих подключений. Это может привести к одновременному подключению в МБ и WLAN/Ethernet. Например, это может произойти во время загрузки системы, когда мб и другие подключения выполняются одновременно, а служба диспетчера списков сети по-прежнему пытается определить подключение к Интернету других подключений с помощью активных и пассивных методов. Это также может произойти из-за временных сбоев в сетевой инфраструктуре, такой как корпоративный прокси-сервер или сеть isp. Таким образом, служба MB может попытаться автоматически подключиться к Интернету независимо от того, выбран ли параметр "Автоматическое подключение только при отсутствии альтернативного подключения к Интернету".
Требования
Версия |
Доступно в Windows 7 и более поздних версиях Windows. |
Заголовок |
Ntddndis.h (включая Ndis.h) |