MB SAR 平台支援
概述
特定吸收率（SAR）是指能夠根據 MBB 天線與用戶的距離改變 MBB 無線電發射機功率的能力。 傳統上，OEM 已為 SAR 實作專屬解決方案。 這需要 OEM 實作裝置服務命令，該命令只能在其使用者模式驅動程式 （UMDF） 和數據機之間識別，或要求核心模式元件直接與數據機互動。 有些 OEM 甚至可能有混合式解決方案，其中它們同時具有 UMDF-數據機和內核模式-數據機元件。 隨著無線電輻射意識的提高，標準化 OEM 軟體元件的介面，通過SAR命令傳遞至數據機，帶來了下列優點：
- OEM 可以移至使用者模式元件，並讓系統更加穩定，因為與核心模式相比，使用者模式中的錯誤不會對系統造成嚴重錯誤。
- Windows 提供平台標準介面，並減少 OEM 的專屬實作。
- 想要利用 SAR 的平台服務可以從數據機擷取資訊。
從 Windows 10 版本 1703 開始，Windows 支援傳遞 SAR 配置和數據機傳輸狀態。 Windows 將繼續將 SAR 商業規則留給 IHV 和 OEM，以作為自我區分因素，但會提供一個介面來簡化平臺。 已定義兩個新的 NDIS OID 和兩個新的 MBIM CID 來支援這個介面。 想要利用OS支援的裝置必須實作這兩個命令。
透過新增兩個新的 OID 和 CID 來支援此功能。 對於實作 MBIM 的 IHV 合作夥伴，只需要支援 CID 版本。
注意
本主題定義 IHV 合作夥伴在其數據機設備驅動器中實作 SAR 平台支援的介面。 如果您要尋找為裝置自訂 SAR 對應資料表的相關資訊，請參閱 自定義特定吸收率 （SAR） 對應資料表。
流
SAR 平台支援的 MB 介面更新
MBIM 相容的裝置會在CID_MBIM_DEVICE_SERVICES查詢時，實作並報告下列裝置服務。 現有的已知服務定義於USB NCM MBIM 1.0 規格的第10.1節中。 Microsoft會擴充此專案，以定義下列服務。
服務名稱 = Microsoft SAR 控制
UUID = UUID_MS_SARControl
UUID 值 = 68223D04-9F6C-4E0F-822D-28441FB72340
| CID | 最低OS版本 |
|---|---|
| MBIM_CID_MS_SAR_CONFIG | Windows 10 版本 1703 |
| MBIM_CID_MS_TRANSMISSION_STATUS | Windows 10 版本 1703 |
MBIM_CID_MS_SAR_CONFIG
描述
此命令會設定或傳回 MB 裝置 SAR 退關模式和層級的相關信息。 MB 裝置必須立即對 SAR 退縮命令採取行動，覆寫目前的發射功率限制，並將它們應用到發射天線。 如果作系統未變更天線的SAR設定，則應維持其目前的設定。 例如，如果作業系統將天線 1 設定為 SAR 退載索引 1，則天線 2 的組態應該保持不變。
支援此命令的裝置應該實作 Query，以便將裝置資訊提供給 OS 及其用戶端。 針對 Set 命令，其介於 IHV 與 OEM 之間，以定義每個欄位的可接受值。 典型的預期是，所有天線的SAR回退指數都可以設置為最低標準。 如果發送的設定要求中包含裝置不支援的欄位，則必須返回 MBIM_STATUS_INVALID_PARAMETERS 作為狀態代碼。
在每個查詢或設定回應之後，數據機應該會傳回MBIM_MS_SAR_CONFIG結構，其中包含與行動寬頻相關聯裝置上所有天線的資訊。
查詢
MBIM_COMMAND_MSG 的 InformationBuffer 不會被使用。 MBIM_MS_SAR_CONFIG會在 MBIM_COMMAND_DONE 的 InformationBuffer 中傳回。
設定
MBIM_COMMAND_MSG 中的 InformationBuffer 包含 MBIM_MS_SAR_CONFIG。 MBIM_MS_SAR_CONFIG會在 MBIM_COMMAND_DONE 的 InformationBuffer 中傳回。
未請求的事件
不適用。
參數
| 操作 | 設置 | 查詢 | 通知 |
|---|---|---|---|
| 命令 | MBIM_MS_SET_SAR_CONFIG | 不適用 | 不適用 |
| 回應 | MBIM_MS_SAR_CONFIG | MBIM_MS_SAR_CONFIG | 不適用 |
數據結構
查詢
InformationBuffer 應為 NULL，InformationBufferLength 應為零。
設置
下列MBIM_MS_SET_SAR_CONFIG結構應用於 InformationBuffer。
| 抵消 | 大小 | 田 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | SARMode | MBIM_MS_SAR_CONTROL_MODE | 如需詳細資訊，請參閱MBIM_MS_SAR_CONTROL_MODE數據表。 |
| 4 | 4 | SAR退避狀態 (SARBackOffStatus) | MBIM_MS_SAR_BACKOFF_STATE | 如需詳細資訊，請參閱MBIM_MS_SAR_BACKOFF_STATE數據表。 如果MBIM_MS_SAR_CONTROL_MODE設定為受裝置控制，則OS將無法設定此欄位。 |
| 8 | 4 | ElementCount （EC） | UINT32 | DataBuffer 中後續MBIM_MS_SAR_CONFIG結構的計數。 |
| 12 | 8 * EC | SAR設定狀態參考列表 | OL_PAIR_LIST | 配對的第一個元素是相對於此 MBIM_MS_SET_SAR_CONFIG 結構的開頭（偏移量 0）到 MBIM_MS_SAR_CONFIG_STATE 結構的計算結果為4位元組偏移量。 如需詳細資訊，請參閱MBIM_MS_SAR_CONFIG_STATE數據表。 配對的第二個元素是指向對應 MBIM_MS_SAR_CONFIG_STATE 結構的指標，該指標的大小為 4 位元組。 |
| 12 + （8 * EC） | 資料緩衝區 | DATABUFFER | MBIM_MS_SAR_CONFIG_STATE 結構的陣列。 |
上表中會使用下列結構。
MBIM_MS_SAR_CONTROL_MODE會指定如何控制 SAR 退關機制。
| 類型 | 價值 | 描述 |
|---|---|---|
| MBIMMsSARControlModeDevice | 0 | SAR 退關機制由數據機裝置直接控制。 |
| MBIMMsSARControlModeOS | 1 | SAR 回退機制由作業系統控制及管理。 |
MBIM_MS_SAR_BACKOFF_STATE 描述 SAR 回退狀態。
| 類型 | 價值 | 描述 |
|---|---|---|
| MBIMMsSARBackOffStatusDisabled | 0 | 已停用數據機中的SAR回退功能。 |
| MBIMMsSARBackOffStatusEnabled | 1 | 數據機已啟用 SAR 回退功能。 |
MBIM_MS_SAR_CONFIG_STATE描述天線SAR退讓的可用狀態。
| 抵消 | 大小 | 領域 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | SARAntennaIndex | UINT32 | 在此表格中對應到 SARBackOffIndex 欄位的天線索引。 它會對應到天線編號，並保留給 OEM 實作，以編製裝置上每個天線的索引。 任何索引都對此值有效。 如果此值設定為在 Set 命令中 0xFFFFFFFF，則 SARBackOffIndex 應套用至所有天線。 如果此值在回應中設定為 0xFFFFFFFF，這表示 SARBackOffIndex 會套用至所有天線。 |
| 4 | 4 | SARBAckOffIndex | UINT32 | 對應至 OEM 或數據機廠商所定義的退避索引。 數據表具有個別的頻段和相關聯的回退參數。 |
回應
下列MBIM_MS_SAR_CONFIG結構應用於 InformationBuffer。 MBIM_MS_SAR_CONFIG指定 SAR 的組態。
| 抵消 | 大小 | (If "field" refers to something other than an agricultural field, choose the appropriate translation from the options above). | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | SAR模式 | MBIM_MS_SAR_MODE | 如需詳細資訊，請參閱MBIM_MS_SAR_CONTROL_MODE數據表。 |
| 4 | 4 | SAR 後退狀態 | MBIM_MS_SAR_BACKOFF_STATE | 如需詳細資訊，請參閱MBIM_MS_SAR_BACKOFF_STATE數據表。 |
| 8 | 4 | SARWifiIntegration | MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION | 如需詳細資訊，請參閱MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION數據表。 這表示裝置的 Wi-Fi 和行動通信SAR整合於硬體層級上，因此裝置會自動調整兩個無線電的SAR控制。 |
| 12 | 4 | ElementCount （EC） | UINT32 | DataBuffer 中後續MBIM_MS_SAR_CONFIG_STATE結構的計數。 |
| 16 | 8 * EC | SARConfigStatusRefList | 配對清單 | 配對中的第一個元素是 4 位元組的位移，從這個 MBIM_MS_SAR_CONFIG 結構的起始位置（位移 0）計算，指向一個 MBIM_MS_SAR_CONFIG_STATE 結構。 如需詳細資訊，請參閱MBIM_MS_SAR_CONFIG_STATE數據表。 配對的第二個元素是一個大小為4 -byte的指標，指向相應的MBIM_MS_SAR_CONFIG_STATE結構。 |
| 16 + （8 * EC） | 資料緩衝區 | 資料緩衝區 | MBIM_MS_SAR_CONFIG_STATE 結構的陣列。 |
上表中會使用下列 MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION 結構。 它說明 Wi-Fi 和行動通訊是否在硬體層級整合。
| 類型 | 價值 | 描述 |
|---|---|---|
| MBIMMsSARWifi硬件集成 | 0 | Wi-Fi 和行動電話數據機 SAR 已整合到裝置中。 |
| MBIM/MS 無線網路硬體未整合 | 1 | Wi-Fi 和行動數據機 SAR 不包含在裝置中。 |
通知
不適用。
狀態代碼
| 錯誤碼 | 描述 |
|---|---|
| MBIM_STATUS_SUCCESS | 已成功處理要求。 |
| MBIM_STATUS_BUSY | 裝置目前忙碌中。 |
| MBIM_STATUS_FAILURE | 要求失敗。 |
| MBIM狀態_不支持設備 | 裝置不支援此命令。 |
| MBIM_STATUS_INVALID_PARAMETERS | 作業因為參數無效而失敗。 |
| MBIM_STATUS_OPERATION_NOT_ALLOWED | 操作失敗，因為操作不被允許。 |
MBIM_CID_MS_TRANSMISSION_STATUS
描述
此命令用於啟用或停用數據機在傳輸狀態下的通知。 這是每個執行程式命令，因為每個執行程式可以有不同的通道傳輸狀態。 例如，雙 SIM 數據機可能有一個使用 LTE，另一個則使用 GSM。 同時，它可以用來提供數據機的傳輸狀態。 此通知可用於對數據機是否傳輸資料感興趣的用戶端。 數據機應該會在 TX 流量開始或結束時提供通知。 如果工作週期太小，無法即時提供給主機，則可以使用滯後定時器將 TX 狀態在一段設定的時間內保持為活躍狀態，然後再發送狀態更新。 例如，TX 的短暫高載，數據機可能無法及時提供開始和結束通知。 當 TX 流量開始時，數據機應發送通知，並應在遲滯定時器期間繼續監控其 TX 流量。 如果在定時器的時間範圍內不會產生更多 TX 流量，則應該報告 TX 流量已結束。
在同時連接 Wi-Fi 和 LTE 的情境中，這是非常有用的。 如果 LTE 和 Wi-Fi 都處於傳輸狀態且偵測到鄰近性，則可能需要 Wi-Fi 關閉。 如果 LTE 不是處於傳輸狀態，但 Wi-Fi 是處於該狀態，則可能不需要 Wi-Fi 退避。 這適用於一般Wi-Fi/LTE連線和行動熱點案例。
Wi-Fi 退機制和命令已脫離此規格的範圍。
使用此命令的 OEM 應該注意潛在的電源影響，因為數據機可能隨時傳送與傳輸相關的通知，包括降低電源狀態。 根據預設，OS 不允許此通知在新式待命期間喚醒 AP，以改善電源效能。
查詢
不會使用 MBIM_COMMAND_MSG 的 InformationBuffer。 MBIM_MS_TRANSMISSION_STATUS_INFO會在 MBIM_COMMAND_DONE 的 InformationBuffer 中傳回。
設置
MBIM_COMMAND_MSG 中的 InformationBuffer 包含 MBIM_MS_SET_TRANSMISSION_STATUS。 MBIM_MS_TRANSMISSION_STATUS_INFO會在 MBIM_COMMAND_DONE 的 InformationBuffer 中傳回。
未請求的事件
未經請求的事件包含MBIM_MS_TRANSMISSION_STATUS_INFO，並在有作用中無線 （OTA） 通道的變更時傳送。 例如，如果數據機開始上傳封包數據，則必須在使用網路數據通道時設定上行通道，以便上傳承載。 這將觸發通知被提供給作業系統。
參數
| 操作 | 設置 | 查詢 | 通知 |
|---|---|---|---|
| 命令 | MBIM_MS_SET_TRANSMISSION_STATUS | 不適用 | 不適用 |
| 回應 | MBIM_MS_TRANSMISSION_STATUS_INFO | MBIM_MS_TRANSMISSION_STATUS_INFO | MBIM_MS_TRANSMISSION_STATUS_INFO |
數據結構
查詢
MBIM_COMMAND_MSG 上的 InformationBuffer 未被使用。 MBIM_MS_TRANSMISSION_STATUS_INFO會在 MBIM_COMMAND_DONE 的 InformationBuffer 中傳回。
設置
下列MBIM_MS_SET_TRANSMISSION_STATUS結構應用於 InformationBuffer。
| 抵消 | 大小 | 田 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | 頻道通知 | MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION | 如需詳細資訊，請參閱MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION數據表。 |
| 4 | 4 | HysteresisTimer | UINT32 | 數據機用來判斷何時將 MBIMMSTransmissionStateInactive 傳送至主機的遲滯指標。 這個值是數據機在傳送 OFF 指標給主機之前視為連續無傳輸活動的定時器。 此定時器應以秒為單位設定，範圍從 1 秒到 5 秒。 |
上述表格中使用到以下的 MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION 結構。 它會指定數據機通道信道傳輸已停用或啟用。
| 類型 | 價值 | 描述 |
|---|---|---|
| MBI多接入傳輸通知已停用 | 0 | 數據機信道傳輸狀態通知已停用。 |
| MBIMMsTransmissionNotificationEnabled | 1 | 已啟用數據機通道信道傳輸狀態通知。 |
回應
下列MBIM_MS_TRANSMISSION_STATUS_INFO結構用於回應。
| 抵消 | 大小 | 田 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | 頻道通知 | MBIM_MS_傳輸狀態通知 | 如需詳細資訊，請參閱MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION數據表。 |
| 4 | 4 | 傳輸狀態 | MBIM_MS_TRANSMISSION_STATUS | 如需詳細資訊，請參閱MBIM_MS_TRANSMISSION_STATUS數據表。 這表示數據機是否每5秒有 TX 流量。 |
| 8 | 4 | HysteresisTimer | UINT32 | 數據機用來判定何時將 MBIMMSTransmissionStateInactive 傳送到主機的遲滯指示器。 這個值是數據機在傳送 OFF 指標給主機之前視為連續無傳輸活動的定時器。 此定時器應以秒為單位設定，範圍從 1 秒到 5 秒。 |
上表中會使用下列MBIM_MS_TRANSMISSION_STATUS結構。 它指出數據機是否每5秒有 TX 流量。
| 類型 | 價值 | 描述 |
|---|---|---|
| MBIMMsTransmissionStateInactive | 0 | 調制解調器在最近的 HysteresisTimer 值期間，並未持續性地主動傳輸數據。 |
| MBIMMsTransmissionStateActive | 1 | 數據機正在積極傳輸數據。 |
通知
如需詳細資訊，請參閱MBIM_MS_TRANSMISSION_STATUS_INFO數據表。
狀態代碼
| 錯誤碼 | 描述 |
|---|---|
| MBIM_STATUS_SUCCESS | 已成功處理要求。 |
| MBIM_STATUS_BUSY 狀態：忙碌 | 裝置目前忙碌中。 |
| MBIM_STATUS_FAILURE（狀態失敗） | 要求失敗。 |
| 裝置不支援狀態 MBIM | 裝置不支援此命令。 |
| MBIM_STATUS_INVALID_PARAMETERS（無效參數） | 作業因為參數無效而失敗。 |
| MBIM_STATUS_OPERATION_NOT_ALLOWED | 操作失敗，因為不被允許。 |
硬體實驗室套件（HLK）測試
請參閱安裝 HLK 的步驟。
在 HLK Studio 中，連線到行動網路數據機驅動程式並執行測試：Win6_4.MB.GSM.Data.TestSAR。
此測試包含下列測試：
| 測試名稱 | 描述 |
|---|---|
| QuerySarConfig | 此測試會驗證測試可以成功查詢 SAR 組態。 |
| SetSarConfig | 此測試會驗證測試可以成功設定 SAR 組態。 |
| 查詢Sar傳輸狀態 | 此測試會驗證測試可以成功查詢 SAR 傳輸狀態。 |
| SetSarTransmissionStatus | 此測試會驗證測試可以成功設定 SAR 傳輸狀態。 |
WinRT API
記錄分析
您可以使用下列指示來收集和譯碼記錄：MB 收集記錄。
重要提供者和對應的關鍵詞
Microsoft-Windows-WWAN-SVC-EVENTS （3cb40aaa-1145-4fb8-b27b-7e30f0454316）
篩選的關鍵字：
- SarConfig
- CWwanSar：：OnNdisNotification
- LoadSemiStaticOEMSARTable
- AttemptAutoConfigureSAR
- PreCheckSemiStaticOEMSARTable
- WwanIntfOpcodeSarConfig
- WwanIntfOpcodeSar傳輸狀態
- WwanMsmEventTypeSarConfig
- WwanMsmEventTypeSarTransmissionStatus
MobileBroadband WinRT WPP （56dd9c57-06cc-48ba-b123-876a6495ba13）
篩選的關鍵詞：MobileBroadbandSarManager
WwanProtDIM （3a07e1ba-3a6b-49bf-8056-c105b54dd7fb）
篩選的關鍵字：
- NDIS_WWAN_SAR_CONFIG_INFO
- SarMode
- NDIS_WWAN_SAR_TRANSMISSION_STATUS_INFO
- HysteresisTimer