структура WWAN_CONTEXT_STATE (wwan.h)

  • Статья

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

Синтаксис

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

Члены

uNwError

Ошибка для конкретной сети. В следующей таблице показаны значения сбоев подключения, описанные в спецификации 3GPP TS 24.008.

Код причины 3GPP 24.008 Интерпретация кода причины
8 - Оператор определяет запрет Служба пакетных данных блокируется оператором.
26. Недостаточно ресурсов Невозможно активировать контекст из-за нехватки ресурсов в сети.
27 — отсутствует или неизвестное имя точки доступа (APN) В запросе активации не указан ни APN, ни неизвестный APN.
29, 30, 31 — сбой проверки подлинности пользователя Неверное имя пользователя или пароль, указанные в запросе на активацию.
32 . Параметр службы не поддерживается Протоколы ИСПОЛЬЗОВАНИЯ не поддерживаются сетью.
33 . Запрошенный параметр службы не подписан Запрошенная служба (ЗАПРОС) не подписана пользователем.
34 . Параметр службы временно не по порядку Служба пакетных данных временно не по порядку. Пользователь должен повторить попытку позже.
43 — контекст неизвестного протокола пакетных данных (PDP) В запросе активации не указан ни APN, ни неизвестный APN.

ConnectionId

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

ActivationState

Текущее состояние активации устройства.

VoiceCallState

Текущее состояние голосового вызова устройства.

IPType

Значение из перечисления WWAN_IP_TYPE, указывающее тип IP-адреса.

ConnectionMedia

Тип носителя для установленного контекста или сеанса.

AccessString[WWAN_ACCESSSTRING_LEN]

Выбранный APN/DNN для установленного контекста или сеанса.

Snssai

Структура WWAN_SINGLE_NSSAI , представляющая одну информацию о выборе сетевого среза (NSSAI).

FoundMatchingConnectionId

Допустимо только в том случае, если состояние WWAN_STATUS_SESSION_ALREADY_EXISTS.

TrafficParameters

Структура WWAN_OFFSET_SIZE_ELEMENT . Допустимо только в том случае, если состояние WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. Первые 4 байта — это смещение dataBuffer, содержащего необработанные данные MBIM_TLV_TYPE_TRAFFIC_PARAMETERS в байтах, вычисленные с начала WWAN_SET_CONTEXT_STATE. Вторые 4 байта — это размер необработанных данных MBIM_TLV_TYPE_TRAFFIC_PARAMETERS в байтах.

Комментарии

Установить Запросы OID, а также нежелательные события состояния используют элемент uNwError . Если ошибка, связанная с сетью, отсутствует или она неизвестна, драйверы мини-порта должны установить для этого члена значение 0.

Ниже приведены рекомендации по возврату ошибок, относящихся к сети, в разных сценариях.

  • Если запрос набора завершается ошибкой, драйверы мини-порта должны возвращать код ошибки для конкретной сети. В этом случае драйвер мини-порта должен задать элемент uStatus структуры NDIS_WWAN_CONTEXT_STATE на WWAN_STATUS_FAILURE или более конкретную ошибку, например WWAN_STAUS_INVALID_ACCESS_STRING или WWAN_STATUS_INVALID_USER_NAME_PWD, и задать для элемента uNwError код ошибки, относящийся к сети.
  • Всякий раз, когда состояние активации контекста устройства изменяется из-за отключения контекста, инициированного сетью, незапрошенные события состояния должны включать в себя ошибку, связанную с сетью. В этом случае драйвер мини-порта должен задать для элемента uStatus структуры NDIS_WWAN_CONTEXT_STATE значение WWAN_STATUS_SUCCESS, а для элемента uNwError — код ошибки, относящийся к сети.
Драйверы miniport могут предоставлять дополнительные коды ошибок, как определено спецификацией стандартов GSM кодов ошибок активации контекста, возвращаемых сетью. Например, драйверы минипорта могут передавать коды ошибок контекстной активации TS 24.008 спецификации 3GPP, такие как код ошибки 8 (оператор определяет запрет), в службу MB через член uNwError . Стандарт для сетевых кодов ошибок на основе CDMA недоступен. Устройства и сети на основе CDMA могут возвращать сведения о коде ошибки сети с помощью элемента uNwError .

В случае ответа на NDIS_WWAN_SET_CONTEXT_STATE используйте этот элемент для предоставления дополнительных кодов ошибок, возвращаемых сетью.

Требования

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

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

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE