структура WWAN_SET_CONTEXT_STATE (wwan.h)
Структура WWAN_SET_CONTEXT_STATE представляет команду для задания состояния контекста протокола ДАННЫХ пакетов (PDP) устройства MB.
Синтаксис
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 и соответствующего состояния.
Служба МБ использует значение этого члена для уникальной идентификации текущего активного контекста в сетевых адаптерах МБ.
Минипорт-драйвер должен использовать значение в этом элементе при выполнении задания запросов. Служба МБ использует значение этого члена в последующих запросах, а также отключает запросы к драйверу мини-порта.
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 | Используйте протокол проверки подлинности (CHAP) microsoft Challenge Handshake (CHAP) версии 2.0. |
IPType
Значение из перечисления WWAN_IP_TYPE, указывающее тип IP-адреса.
MediaPreference
ConnectionMediaSource
ActivationOption
Значение из перечисления WWAN_ACTIVATION_OPTION, представляющего параметры активации протокола PDP, поддерживаемые устройством MB.
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 (include Wwan.h) |