OID_WWAN_CONNECT
OID_WWAN_CONNECT會啟動或停用特定封包內容,並讀取內容的啟用狀態。
迷你埠驅動程式必須以非同步方式處理設定和查詢要求,一開始傳回NDIS_STATUS_INDICATION_REQUIRED給原始要求,然後傳送 包含 NDIS_STATUS_WWAN_CONTEXT_STATE NDIS_WWAN_CONTEXT_STATE結構 ( PDP) MB 裝置內容狀態的 封 包資料通訊協定) 狀態的NDIS_WWAN_CONTEXT_STATE狀態。
要求設定封包資料通訊協定 (PDP 的呼叫端,) MB 裝置的內容狀態會提供 NDIS_WWAN_SET_CONTEXT_STATE 結構給迷你埠驅動程式,並提供適當的資訊。
備註
如需使用此 OID 的詳細資訊,請參閱 WWAN 封包內容管理。
此物件會啟動或停用特定的封包內容,並讀取內容的啟用狀態。 每當啟用狀態變更時,迷你埠驅動程式必須傳送適當的事件通知。
只有在迷你埠驅動程式處於 WwanRegisterStateHome、 WwanRegisterStatePartner或 WwanRegisterStateRoaming的登錄狀態時,才會呼叫這個物件。 當封包服務處於作用中狀態時,裝置也必須處於 WwanPacketServiceStateAttached 的附加狀態。
此物件同時支援 set 和 query 作業。
處理集合要求需要網路存取,但不需要 SIM 卡存取。
查詢要求的處理不需要存取網路或 SIM 卡。
此 OID 的資料結構NDIS_WWAN_SET_CONTEXT_STATE。 迷你埠驅動程式會針對設定和查詢要求發出NDIS_STATUS_WWAN_CONTEXT_STATE狀態指示。
在此版本的驅動程式模型中,迷你埠驅動程式只會依照 MB 服務指示嘗試內容啟用。 (Miniport 驅動程式可能會在更新版本中啟動網路起始的內容。) Miniport 驅動程式在遺失註冊或訊號之後,也不得自動啟用內容。 如果未在啟用要求中提供存取字串,迷你埠驅動程式就不應該嘗試提供預設字串。 相反地,它必須繼續啟用具有空白存取字串的內容。
另一方面,迷你埠驅動程式可能會停用內容,如 MB 服務指示。 當網路連線中斷超過暫時性遺失訊號的臨界值,或是正常關機或狀態清除的一部分時,可能會發生這種情況。
由於此版本僅支援一個啟動的內容,因此啟用或停用特定內容數量,以設定或卸載第 2 MB 層連線。
在設定要求時,MB 服務會在WWAN_CONTEXT_STATE資料結構中啟用 ConnectionId 和 ActivationCommand 參數。 它會指示迷你埠驅動程式根據ActivationCommand參數值WwanActivationCommandActivate 或 WwanActivationCommandDeactivate來啟動或停用ConnectionId所識別的封包內容。
如果服務或訂用帳戶需要啟用,迷你埠驅動程式應該會傳回錯誤碼WWAN_STATUS_SERVICE_NOT_ACTI加值稅ED。 在啟動服務或訂用帳戶之前,可能不會發生 PDP 啟用。 所有緊急服務可能會受限於裝置和操作員的支援。 作業系統可能會呼叫 OID_WWAN_SERVICE_ACTI加值稅ION,以回應此錯誤碼。
如果迷你埠驅動程式在目前啟用另一個封包內容時收到內容啟用要求,則會傳回錯誤碼WWAN_STATUS_MAX_ACTI加值稅ED_CONTEXTS。
如果迷你埠驅動程式收到內容停用要求,但 ConnectionId 所識別的內容目前未啟動,則會傳回錯誤碼WWAN_STATUS_CONTEXT_NOT_ACTI加值稅ED。
迷你埠驅動程式會使用下列邏輯,從設定要求判斷 AccessString、UserName 和 Password 設定的有效性:
- 如果 ActivationCommand 是 WwanActivationCommandDeactivate,迷你埠驅動程式應該忽略這三個參數的設定。 其餘案例只會考慮 ActivationCommand 為 WwanActivationCommandActivate時的案例。
內容啟用會在使用者登入和登出之間保存。 它不是每一個登入使用者。
在查詢要求上,MB 服務會使用此物件來找出啟用狀態。
若要回應查詢要求,迷你埠驅動程式會傳送NDIS_STATUS_WWAN_CONTEXT_STATE通知。
重要 注意:
在罕見但特定的情況下,Windows 7 上的 MB 服務可能會嘗試在連線到網際網路之前自動連線,或是在預先存在的連線中斷期間判斷為預先存在的連線。 這可能會導致同時進行 MB 和 WLAN/乙太網路連線。 例如,當同時嘗試 MB 和其他連線,且網路清單管理員服務仍在嘗試使用主動和被動方法判斷其他連線的網際網路連線時,可能會發生此問題。 也可能因為公司 Proxy 伺服器或 ISP 網路之類的網路基礎結構暫時中斷而發生。 因此,MB 服務可能會嘗試自動連線到網際網路,而不論是否選取 [只有在沒有可用的替代網際網路連線時才自動連線] 選項。
規格需求
版本 |
適用于 Windows 7 和更新版本的 Windows。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |