OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE設定或傳回 MB 裝置無線電電源狀態的相關資訊。
迷你埠驅動程式必須以非同步方式處理設定和查詢要求,一開始將NDIS_STATUS_INDICATION_REQUIRED傳回至原始要求,稍後傳送包含NDIS_WWAN_RADIO_STATE結構NDIS_STATUS_WWAN_RADIO_STATE狀態通知,指出 MB 裝置目前的無線電電源狀態,而不論完成集合或查詢要求為何。
要求設定 MB 裝置無線電電源狀態的呼叫端會提供具有適當資訊的迷你埠驅動程式 NDIS_WWAN_SET_RADIO_STATE 結構。
備註
如需使用此 OID 的詳細資訊,請參閱 MB 無線電狀態。
處理查詢或設定作業時,迷你埠驅動程式不應該存取提供者網路或訂閱者身分識別模組 (SIM 卡) 。
迷你埠驅動程式必須在系統重新開機或裝置移除和重新執行之間保留軟體無線電電源狀態。 迷你埠驅動程式應該儲存裝置的軟體無線電資訊,並用於在每次重新開機或重新開機裝置時,立即設定裝置軟體無線電電源狀態。 根據 WWAN_RADIO_STATE資料表,決定裝置的有效無線電電源狀態。
如果值為 WwanRadioOn,迷你埠驅動程式必須開啟無線電電源,並將 WWAN_RADIO_STATE 結構的 RadioState.SwRadioState 成員設定為 WwanRadioOn。 如果 RadioState.HwRadioState 成員是 WwanRadioOff,迷你埠驅動程式應該快取此電源狀態資訊,並確保 在 RadioState.HwRadioState 變更為 WwanRadioOn時實際開啟無線電電源狀態。
如果值為 WwanRadioOff,迷你埠驅動程式必須關閉無線電電源狀態,並將 RadioState.SwRadioState 成員設定為 WwanRadioOff。
請參閱下表,以取得迷你埠驅動程式的預期無線電狀態程式設計。
PIN 模式和 PIN 狀態的有效組合
HwRadioState 值 | SwRadioState 值 | 整體無線電電源狀態 |
---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
對於未提供硬體無線電電源交換器的裝置,NDIS_WWAN_RADIO_STATE 結構的 RadioState.HwRadioState 成員一律必須設定為 WwanRadioOn。
從 1703 版Windows 10開始,OID_WWAN_RADIO_STATE有其他規格,說明多執行程式支援的數據機應該如何處理來自 OS 的無線電狀態設定。
透過支援多重執行程式的數據機,每個執行程式設定無線電電源狀態有一個電源優點。 當執行程式的無線電關閉時,OS 預期數據機會從網路取消註冊,而且不會嘗試從網路進行任何掃描或位置更新。 數據機應針對它向 OS 公告的每個執行程式支援無線電狀態,以便判斷其應採用的硬體電源狀態。
例如,如果數據機有兩個執行程式,另一個執行程式無線電已關閉,則數據機可能會讓 RF 前端保持開啟狀態,以維護其無線電開啟但不需要掃描/ping/位置更新或其他關閉執行程式列動服務之執行程式的註冊。 如果兩個無線電都關閉,數據機可以關閉其 RF 前端,並將整體硬體帶到較低的電源狀態。 實作細節會保留給每個 IHV。
規格需求
版本 |
可在 Windows 7 和更新版本的 Windows 中使用。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |