Поделиться через

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

  • Статья

Структура WWAN_SET_CONTEXT_STATE представляет команду для задания состояния контекста протокола пакетных данных (PDP) устройства в МБ.

Синтаксис

typedef struct _WWAN_SET_CONTEXT_STATE {
  ULONG                     ConnectionId;
  WWAN_ACTIVATION_COMMAND   ActivationCommand;
  WCHAR                     AccessString[WWAN_ACCESSSTRING_LEN];
  WCHAR                     UserName[WWAN_USERNAME_LEN];
  WCHAR                     Password[WWAN_PASSWORD_LEN];
  WWAN_COMPRESSION          Compression;
  WWAN_AUTH_PROTOCOL        AuthType;
  WWAN_IP_TYPE              IPType;
  WWAN_PSMEDIA_PREFERENCE   MediaPreference;
  WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
  WWAN_ACTIVATION_OPTION    ActivationOption;
  WWAN_SINGLE_NSSAI         Snssai;
  WWAN_OFFSET_SIZE_ELEMENT  TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;

Члены

ConnectionId

Служба MB задает этот член для уникальной идентификации контекста PDP и соответствующего ему состояния.

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

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

ActivationCommand

Активация или деактивация контекста PDP, на который ссылается член ConnectionId . В следующей таблице показаны возможные значения, которые может указать драйвер мини-порта.

Значение Значение
WwanActivationCommandActivate Активация контекста PDP, на который ссылается ConnectionId .
WwanActivationCommandDeactivate Деактивируйте активированный контекст PDP, на который ссылается ConnectionId .

AccessString[WWAN_ACCESSSTRING_LEN]

Строка с завершением NULL для доступа к сети. Для сетей на основе GSM это будет строка APN, например "data.thephone-company.com". Для сетей на основе CDMA это может быть специальный код набора, например "#777", или идентификатор доступа к сети (NAI), например "foo@thephone-company.com". Этот элемент может иметь значение NULL.

Размер строки не должен превышать 100 байт.

UserName[WWAN_USERNAME_LEN]

Строка с завершением NULL, представляющая имя пользователя для проверки подлинности. Этот элемент может иметь значение NULL.

Password[WWAN_PASSWORD_LEN]

Строка, завершающаяся значением NULL, представляющая пароль имени пользователя. Этот элемент может иметь значение NULL.

Compression

Значение из перечисления WWAN_COMPRESSION, указывающее, следует ли использовать сжатие в подключении к данным для заголовка и данных. Этот элемент применяется только к устройствам на основе GSM. Служба MB задает для этого члена значение WwanCompressionNone для устройств на основе CDMA.

Значение Значение
WwanCompressionNone Сжатие не применяется.
WwanCompressionEnable Включите сжатие заголовков и данных.

AuthType

Значение из перечисления WWAN_AUTH_PROTOCOL, указывающее тип проверки подлинности, используемый для активации PDP. Этот элемент применяется только к устройствам на основе GSM. Служба MB задает для этого члена значение WwanAuthProtocolNone для устройств на основе CDMA.

Значение Значение
WwanAuthProtocolNone Нет протокола проверки подлинности.
WwanAuthProtocolPap Проверка подлинности с незашифрованным паролем.
WwanAuthProtocolChap Используйте протокол проверки подлинности подтверждения запроса (CHAP).
WwanAuthProtocolMsChapV2 Используйте протокол проверки подлинности microsoft challenge Handshake Authentication Protocol (CHAP) версии 2.0.

IPType

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

MediaPreference

ConnectionMediaSource

ActivationOption

Значение из перечисления WWAN_ACTIVATION_OPTION , представляющее параметры активации по протоколу PDP, поддерживаемые устройством в МБ.

Snssai

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

TrafficParameters

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

Требования

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

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

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION