共用方式為

NDIS_WWAN_CONTEXT_STATE 結構 (ndiswwan.h)

  • 發行項

NDIS_WWAN_CONTEXT_STATE 結構代表 MB 裝置的封包數據通訊協定 (PDP) 內容狀態。

語法

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

成員

Header

具有NDIS_WWAN_CONTEXT_STATE結構之類型、修訂和大小資訊的標頭。 MB 服務會使用下表中顯示的值來設定標頭，當數據結構傳送至 用於設定 作業的迷你埠驅動程式時， 當迷你埠驅動程式將數據結構傳送至 MB 服務時，必須使用相同的值來設定標頭。

標頭子成員 值
類型 NDIS_OBJECT_TYPE_DEFAULT
修訂版 Windows 8 迷你埠驅動程序應該將此設定為 NDIS_WWAN_CONTEXT_STATE_REVISION_2。 Windows 7 迷你埠驅動程式應該將此設定為 NDIS_WWAN_CONTEXT_STATE_REVISION_1。
大小 sizeof (NDIS_WWAN_CONTEXT_STATE)
 

如需這些成員的詳細資訊，請參閱 NDIS_OBJECT_HEADER。

uStatus

內容啟用或停用作業的狀態。 下表顯示這個成員的可能值。

值 意義
WWAN_STATUS_SUCCESS 內容啟用或停用成功。
WWAN_STATUS_FAILURE 作業失敗。 如果內容已經啟動，迷你埠驅動程式可以傳回此值。
WWAN_STATUS_PIN_REQUIRED 作業失敗，因為裝置需要 PIN。
WWAN_STATUS_BAD_SIM 作業失敗，因為偵測到不正確的 SIM 卡。
WWAN_STATUS_SIM_NOT_INSERTED 作業失敗，因為 SIM 卡未完全插入裝置中。
WWAN_STATUS_NOT_INITIALIZED 作業失敗，因為裝置正在進行初始化。 在裝置就緒狀態變更為 WwanReadyStateInitialized 之後重試作業。
 

除了先前所述的錯誤碼之外，迷你埠驅動程式還可以傳回下列錯誤碼 (，但只有在發生設定失敗的 PDP 啟用作業時，才會傳回這些) 錯誤碼。

值 意義
WWAN_STATUS_RADIO_POWER_OFF 作業失敗，因為無線電目前已關閉。 只有在回應OID_WWAN_CONNECT 集 要求時，才應該傳回此錯誤碼。 如果無線電狀態已關閉，迷你埠驅動程式應該回應 OID_WWAN_CONNECT具有 WWAN_STATUS_SUCCESS的查詢 要求，並將目前的內容狀態指定為 WwanActivationStateDeactivated。
WWAN_STATUS_SERVICE_NOT_ACTIVATED 作業失敗，因為訂用帳戶已過期，或裝置不允許 PDP 啟用。
WWAN_STATUS_PROVIDER_NOT_VISIBLE 作業失敗，因為服務提供者目前看不到。
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS 作業失敗，因為已達到啟動的內容數目上限。
WWAN_STATUS_INVALID_ACCESS_STRING 作業失敗，因為存取字串無效。
WWAN_STATUS_INVALID_USER_NAME_PWD 作業失敗，因為提供的用戶名稱和/或密碼無效。 uNwError 中可能會提供網路特定錯誤碼。
WWAN_STATUS_PACKET_SVC_DETACHED 作業失敗，因為封包服務已中斷連結。
WWAN_STATUS_NOT_REGISTERED 作業失敗，因為裝置未處於註冊狀態，無法執行 PDP 啟用。
WWAN_STATUS_VOICE_CALL_IN_PROGRESS 作業失敗，且無法繼續進行 PDP 啟用，因為語音通話目前正在進行中。 此值僅適用於語音類別設定為 WwanVoiceClassSeparateVoiceData 的裝置。
WWAN_STATUS_CONTEXT_NOT_ACTIVATED 作業失敗，因為 ConnectionId 所識別的內容不是目前啟用的內容。

ContextState

格式化 WWAN_CONTEXT_STATE 物件，表示裝置的封包數據通訊協定 (PDP) 內容狀態。

規格需求

需求 值
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 中使用。
標頭 ndiswwan.h (包括 Ndiswwan.h)

另請參閱

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE