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 上下文及其相应状态。

MB 服务使用此成员中的 值跨 MB 网络适配器唯一标识当前活动上下文。

完成 设置 请求时，微型端口驱动程序必须使用此成员中的 值。 MB 服务在后续 查询 请求中使用此成员中的值，并断开对微型端口驱动程序的请求的连接。

ActivationCommand

激活或停用 ConnectionId 成员中引用的 PDP 上下文。 下表显示了微型端口驱动程序可以指定的可能值。

值 含义
WwanActivationCommandActivate 激活 ConnectionId 引用的 PDP 上下文。
WwanActivationCommandDeactivate 停用 由 ConnectionId 引用的当前激活的 PDP 上下文。

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 的设备。 对于基于 CDMA 的设备，MB 服务将此成员设置为 WwanCompressionNone 。

值 含义
WwanCompressionNone 不应用任何压缩。
WwanCompressionEnable 启用标头和数据压缩。

AuthType

WWAN_AUTH_PROTOCOL 枚举中的值，该值指定要用于 PDP 激活的身份验证类型。 此成员仅适用于基于 GSM 的设备。 对于基于 CDMA 的设备，MB 服务将此成员设置为 WwanAuthProtocolNone 。

值 含义
WwanAuthProtocolNone 无身份验证协议。
WwanAuthProtocolPap 未加密的密码身份验证。
WwanAuthProtocolChap 使用质询握手身份验证协议 (CHAP) 。
WwanAuthProtocolMsChapV2 使用 Microsoft 质询握手身份验证协议 (CHAP) v2.0。

IPType

WWAN_IP_TYPE枚举中的值，该值指定 IP 的类型。

MediaPreference

ConnectionMediaSource

ActivationOption

WWAN_ACTIVATION_OPTION 枚举中的值，表示 MB 设备支持的数据包数据协议 (PDP) 激活选项。

Snssai

表示单个网络切片选择帮助信息 ( NSSAI) 的WWAN_SINGLE_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