структура 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) |