OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX類似于 OID_WWAN_DEVICE_CAPS ,但是個別執行程式 OID,不同于每個裝置 OID OID_WWAN_DEVICE_CAPS。 此 OID 可用來指出硬體的裝置/執行程式功能,包括擴充選擇性功能的功能,例如 LTE 附加 APN 設定。
迷你埠驅動程式必須先以非同步方式處理查詢要求,一開始先將NDIS_STATUS_INDICATION_REQUIRED傳回原始要求,之後再傳送包含NDIS_WWAN_DEVICE_CAPS_EX結構NDIS_STATUS_WWAN_DEVICE_CAPS_EX狀態通知,進而包含WWAN_DEVICE_CAPS_EX結構,以提供裝置功能的相關資訊。
下圖說明查詢要求。
設定要求不適用。
備註
驅動程式必須以整體方式報表服務延伸模組功能,包括從驅動程式到實際裝置。 如果驅動程式支援服務,但基礎硬體不支援該服務,則服務功能應標示為 FALSE。
OID_WWAN_DEVICE_CAPS_EX也可用來擷取每個執行程式的功能。 這個 OID 的結構與現有的 OID_WWAN_DEVICE_CAPS相同, 但會新增 執行程式識別碼。 迷你埠驅動程式應該會報告它支援的最高 OID 版本。
如同 OID_WWAN_DEVICE_CAPS,此 OID 中的參數預期不會因為 SIM 卡而變更,而是代表所選執行程式的數據機 RF 功能。 實體硬體數據機可能會有多個執行程式,因此可能會有多個介面支援OID_WWAN_DEVICE_CAPS_EX。
如需可能的未來更新,如果 OS 的要求版本比裝置支援的版本還新,裝置應該會傳回它支援的 OID 結構最新版本。 如果 OS 的要求版本比裝置支援的最新版本還舊,則裝置應該傳回符合 OS 規格的版本。 IHV 需要確定所有OID_WWAN_DEVICE_CAPS_EX修訂都支援回溯相容性和舊版支援。
不同于其他 OID Windows 10 1703 版的新功能,只有在數據機支援多 SIM/多執行程式時才需要,此 OID 必須針對想要支援任何 Microsoft 定義服務延伸模組的數據機實作,從 Windows 10 1703 版開始。
Windows 10版本 1703 之前的 Windows 版本仍可使用現有的OID_WWAN_DEVICE_CAPS;不支援使用支援多重執行程式之數據機的行為。 IHV 必須定義此行為。
Windows 10 (版本 1903)
從 Windows 10 1903 版開始,OID_WWAN_DEVICE_CAPS_EX已升級至第 2 版。 迷你埠驅動程式必須使用此 OID 的修訂 2,如果迷你埠驅動程式支援 5G,它所包含的資料結構。
當主機使用此 OID 查詢功能時,迷你埠驅動程式必須檢查基礎硬體是否支援 5G 行動資料功能。 如果這樣做,迷你埠驅動程式會根據硬體上限,在WWAN_DEVICE_CAPS_EX結構的WwanDataClass欄位中設定位元遮罩。
此外,在WWAN_DEVICE_CAPS_EX結構的WwanOptionalServiceCaps欄位中,定義了新的選擇性服務位,涵蓋所有新的 5G 相關擴充功能支援。
如需 5G 資料類別支援的詳細資訊,請參閱 MB 5G 資料類別支援。
規格需求
版本 |
Windows 10 (版本 1703) |
標頭 |
Ntddndis.h (包括 Ndis.h) |