WWAN_CONTEXT_STATE结构（wwan.h）
WWAN_CONTEXT_STATE结构表示 MB 设备的数据包数据协议（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 - 不支持服务选项 | 网络不支持 GPRS。 |
| 33 - 未订阅请求的服务选项 | 请求的服务（GPRS）未由用户订阅。 |
| 34 - 服务选项暂时无序 | 数据包数据服务暂时无序。 用户以后必须重试。 |
| 43 - 未知数据包数据协议 （PDP） 上下文 | 激活请求中未提供 APN 或未知 APN。 |
ConnectionId
MB 服务使用 OID_WWAN_CONNECT 指定连接请求时此成员的值。 微型端口驱动程序必须复制此值，并在它们通知 MB 服务后续连接状态更改时使用它。
ActivationState
设备的当前激活状态。
VoiceCallState
设备的当前语音呼叫状态。
IPType
指定 IP 类型的WWAN_IP_TYPE枚举中的值。
ConnectionMedia
已建立上下文/会话的媒体类型。
AccessString[WWAN_ACCESSSTRING_LEN]
为已建立的上下文/会话选择的 APN/DNN。
Snssai
表示单个网络切片选择帮助信息（NSSAI）的 WWAN_SINGLE_NSSAI 结构。
FoundMatchingConnectionId
仅当状态WWAN_STATUS_SESSION_ALREADY_EXISTS时才有效。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT 结构。 仅当状态WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION时有效。 前 4 个字节是 DataBuffer 的偏移量，其中包含从WWAN_SET_CONTEXT_STATE开头计算的MBIM_TLV_TYPE_TRAFFIC_PARAMETERS的原始数据（以字节为单位）。 第二个 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 成员设置为特定于网络的错误代码。
如果响应NDIS_WWAN_SET_CONTEXT_STATE，请使用此成员提供网络返回的其他错误代码。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows 8 及更高版本的 Windows 中可用。 |
| 标头 | wwan.h （包括 Wwan.h） |