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
WWAN_SINGLE_NSSAI 結構,代表單一網路配量選取協助資訊 (NSSAI) 。
FoundMatchingConnectionId
只有在狀態為WWAN_STATUS_SESSION_ALREADY_EXISTS時才有效。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT結構。 只有在狀態為WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION時才有效。 前 4 個字節是 DataBuffer 的位移,其中包含MBIM_TLV_TYPE_TRAFFIC_PARAMETERS的原始數據,以位元組為單位,從WWAN_SET_CONTEXT_STATE開始計算。 第二個 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 成員設定為網路特定的錯誤碼。
如果回應NDIS_WWAN_SET_CONTEXT_STATE,請使用此成員來提供網路傳回的其他錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 及更新版本的 Windows 中提供。 |
標頭 | wwan.h (包含 Wwan.h) |