共用方式為


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 成員設定為網路特定的錯誤碼。
迷你埠驅動程式可以提供其他錯誤碼,如網路傳回的內容啟用錯誤碼的 GSM 標準規格所定義。 例如,迷你埠驅動程式可以透過 uNwError 成員,將 3GPP 規格 TS 24.008 內容啟用錯誤碼,例如錯誤碼 8 (操作員判斷的列補) 。 CDMA 型網路特定錯誤碼沒有標準可用。 CDMA 型裝置和網路可以使用 uNwError 成員傳回網路特定的錯誤碼資訊。

如果回應NDIS_WWAN_SET_CONTEXT_STATE,請使用此成員來提供網路傳回的其他錯誤碼。

規格需求

需求
最低支援的用戶端 Windows 8 及更新版本的 Windows 中提供。
標頭 wwan.h (包含 Wwan.h)

另請參閱

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE