共用方式為

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 作業失敗。 如果內容已啟動，Miniport 驅動程式可以傳回此值。
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 集 要求時，才應該傳回這個錯誤碼。 如果無線電狀態關閉，則迷你埠驅動程式應該回應具有 WWAN_STATUS_SUCCESS 的OID_WWAN_CONNECT 查询 要求，並將目前的內容狀態指定為 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