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