wwan.h) (WWAN_CONTEXT_STATE 结构

项目
02/27/2024

WWAN_CONTEXT_STATE 结构表示数据包数据协议 (PDP) MB 设备的上下文状态。

语法

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。
29、30、31 - 用户身份验证失败	激活请求中提供的用户名或密码错误。
32 - 不支持服务选项	网络不支持 GPRS。
33 - 未订阅请求的服务选项	请求的服务 (GPRS) 不由用户订阅。
34 - 服务选项暂时无序	数据包数据服务暂时无序。用户稍后必须重试。
43 - 未知数据包数据协议 (PDP) 上下文	激活请求中未提供 APN 或未知 APN。

ConnectionId

MB 服务使用 OID_WWAN_CONNECT 指定连接请求时此成员的值。微型端口驱动程序必须复制此值，并在后续连接状态更改时通知 MB 服务时使用它。

ActivationState

设备的当前激活状态。

VoiceCallState

设备的当前语音呼叫状态。

IPType

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

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。

以下几点提供了在不同情况下返回网络特定错误的指南：

如果设置的请求失败，微型端口驱动程序应返回特定于网络的错误代码。在这种情况下，微型端口驱动程序应将NDIS_WWAN_CONTEXT_STATE结构的 uStatus 成员设置为WWAN_STATUS_FAILURE或更具体的错误（如 WWAN_STAUS_INVALID_ACCESS_STRING 或 WWAN_STATUS_INVALID_USER_NAME_PWD），并将 uNwError 成员设置为特定于网络的错误代码。
每当设备上下文激活状态因网络启动的上下文停用而发生更改时，未经请求的状态事件应包含特定于网络的错误。在这种情况下，微型端口驱动程序应将 NDIS_WWAN_CONTEXT_STATE 结构的 uStatus 成员设置为WWAN_STATUS_SUCCESS，并将 uNwError 成员设置为网络特定的错误代码。

微型端口驱动程序可以提供由网络返回的上下文激活错误代码的 GSM 标准规范定义的其他错误代码。例如，微型端口驱动程序可以通过 uNwError 成员将 3GPP 规范 TS 24.008 上下文激活错误代码（如错误代码 8 (操作员确定) ）传达给 MB 服务。没有适用于基于 CDMA 的网络特定错误代码的标准。基于 CDMA 的设备和网络可以使用 uNwError 成员返回特定于网络的错误代码信息。

如果响应NDIS_WWAN_SET_CONTEXT_STATE，请使用此成员提供网络返回的其他错误代码。