структура NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)

Структура NDIS_WWAN_CONTEXT_STATE представляет состояние контекста протокола PDP устройства в МБ.

Синтаксис

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

Члены

Header

Заголовок со сведениями о типе, редакции и размере структуры NDIS_WWAN_CONTEXT_STATE. Служба MB задает заголовок со значениями, приведенными в следующей таблице, при отправке структуры данных в драйвер мини-порта для операций установки . Драйверы минипорта должны задавать заголовок с одинаковыми значениями при отправке структуры данных в службу МБ.

Подмембер заголовка	Значение
Тип	NDIS_OBJECT_TYPE_DEFAULT
Редакция	Windows 8 драйверы минипорта должны установить для этого параметра значение NDIS_WWAN_CONTEXT_STATE_REVISION_2. Драйверы для мини-портов Windows 7 должны установить для этого параметра значение NDIS_WWAN_CONTEXT_STATE_REVISION_1.
Размер	sizeof(NDIS_WWAN_CONTEXT_STATE)

 

Дополнительные сведения об этих элементах см. в разделе NDIS_OBJECT_HEADER.

uStatus

Состояние операции активации или деактивации контекста. В следующей таблице показаны возможные значения для этого элемента.

Значение	Значение
WWAN_STATUS_SUCCESS	Активация контекста или деактивация выполнена успешно.
WWAN_STATUS_FAILURE	Операция не удалась. Драйверы минипорта могут возвращать это значение, если контекст уже активирован.
WWAN_STATUS_PIN_REQUIRED	Операция завершилась сбоем, так как для устройства требуется ПИН-код.
WWAN_STATUS_BAD_SIM	Операция завершилась сбоем, так как обнаружена неправильная КАРТА SIM-карты.
WWAN_STATUS_SIM_NOT_INSERTED	Операция завершилась сбоем, так как карта SIM-карты не была полностью вставлена в устройство.
WWAN_STATUS_NOT_INITIALIZED	Операция завершилась сбоем, так как устройство находится в процессе инициализации. Повторите операцию после того, как состояние готовности устройства изменится на WwanReadyStateInitialized.

 

Драйверы минипорта могут возвращать следующие коды ошибок (в дополнение к описанным выше) только в случае сбоя операции активации pdp.

Значение	Значение
WWAN_STATUS_RADIO_POWER_OFF	Операция завершилась сбоем, так как радио в настоящее время отключен. Этот код ошибки должен возвращаться только в ответ на запрос OID_WWAN_CONNECT set . Если переключатель отключен, драйвер мини-порта должен отвечать на запросы OID_WWAN_CONNECT с помощью WWAN_STATUS_SUCCESS и указать текущее состояние контекста WwanActivationStateDeactivated.
WWAN_STATUS_SERVICE_NOT_ACTIVATED	Операция завершилась сбоем, так как срок действия подписки истек или устройство не разрешает активацию PDP.
WWAN_STATUS_PROVIDER_NOT_VISIBLE	Операция завершилась сбоем, так как поставщик услуг в настоящее время не виден.
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS	Операция завершилась сбоем, так как достигнуто максимальное число активированных контекстов.
WWAN_STATUS_INVALID_ACCESS_STRING	Операция завершилась сбоем, так как строка доступа недопустима.
WWAN_STATUS_INVALID_USER_NAME_PWD	Операция завершилась сбоем, так как предоставленные имя пользователя и (или) пароль недопустимы. Код ошибки для конкретной сети может быть доступен в uNwError .
WWAN_STATUS_PACKET_SVC_DETACHED	Операция завершилась сбоем, так как служба пакетов отключена.
WWAN_STATUS_NOT_REGISTERED	Операция завершилась сбоем, так как устройство не находится в зарегистрированном состоянии для выполнения активации PDP.
WWAN_STATUS_VOICE_CALL_IN_PROGRESS	Операция завершилась сбоем и не может продолжить активацию PDP, так как в настоящее время выполняется голосовой вызов. Это значение применяется только к устройствам с классом голосовой связи wwanVoiceClassSeparateVoiceData.
WWAN_STATUS_CONTEXT_NOT_ACTIVATED	Операция завершилась сбоем, так как контекст, определяемый ConnectionId , не является текущим активированным контекстом.

ContextState

Отформатированный объект WWAN_CONTEXT_STATE , представляющий состояние контекста протокола пакетных данных (PDP) устройства.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть	ndiswwan.h (включая Ndiswwan.h)

См. также раздел

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE