WWAN_SET_CONTEXT_STATE 結構 (wwan.h)
WWAN_SET_CONTEXT_STATE 結構代表命令，用來設定 MB 裝置的封包數據通訊協定 (PDP) 內容狀態。
語法
typedef struct _WWAN_SET_CONTEXT_STATE {
ULONG ConnectionId;
WWAN_ACTIVATION_COMMAND ActivationCommand;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WCHAR UserName[WWAN_USERNAME_LEN];
WCHAR Password[WWAN_PASSWORD_LEN];
WWAN_COMPRESSION Compression;
WWAN_AUTH_PROTOCOL AuthType;
WWAN_IP_TYPE IPType;
WWAN_PSMEDIA_PREFERENCE MediaPreference;
WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
WWAN_ACTIVATION_OPTION ActivationOption;
WWAN_SINGLE_NSSAI Snssai;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;
成員
ConnectionId
MB 服務會指定這個成員來唯一識別 PDP 內容及其對應的狀態。
MB 服務會使用此成員中的 值，以唯一識別跨 MB 網路適配器的目前使用中內容。
完成 設定 要求時，迷你埠驅動程序必須使用這個成員中的值。 MB 服務會在後續 查詢 要求中使用這個成員中的值，以及中斷對迷你埠驅動程式的要求。
ActivationCommand
啟動或停用 ConnectionId 成員中所參考的 PDP 內容。 下表顯示迷你埠驅動程式可以指定的可能值。
| 值 | 意義 |
|---|---|
| WwanActivationCommandActivate | 啟動 ConnectionId 所參考的 PDP 內容。 |
| WwanActivationCommandDeactivate | 停用 ConnectionId 所參考的目前啟用 PDP 內容。 |
AccessString[WWAN_ACCESSSTRING_LEN]
要存取網路的NULL終止字串。 如果是 GSM 型網路，這會是 APN (APN) 字串的存取點名稱，例如 “data.thephone-company.com”。 如果是 CDMA 型網路，這可能是特殊的撥號代碼，例如 “#777” 或網络存取標識符， (NAI) 例如 “foo@thephone-company.com”。 此成員可以是 NULL。
字串的大小不應超過100個字節。
UserName[WWAN_USERNAME_LEN]
NULL 終止的字串，表示要驗證的用戶名稱。 此成員可以是 NULL。
Password[WWAN_PASSWORD_LEN]
NULL 終止的字串，表示使用者名稱的密碼。 此成員可以是 NULL。
Compression
來自 WWAN_COMPRESSION 列舉的值，指定是否應該在標頭和數據的數據連接中使用壓縮。 此成員僅適用於 GSM 型裝置。 MB 服務會將此成員設定為CDMA型裝置的 WwanCompressionNone 。
| 值 | 意義 |
|---|---|
| WwanCompressionNone | 不會套用壓縮。 |
| WwanCompressionEnable | 啟用標頭和數據壓縮。 |
AuthType
來自 WWAN_AUTH_PROTOCOL 列舉的值，指定要用於 PDP 啟用的驗證類型。 此成員僅適用於 GSM 型裝置。 MB 服務會將此成員設定為CDMA型裝置的 WwanAuthProtocolNone 。
| 值 | 意義 |
|---|---|
| WwanAuthProtocolNone | 沒有驗證通訊協定。 |
| WwanAuthProtocolPap | 未加密的密碼驗證。 |
| WwanAuthProtocolChap | 使用 Challenge Handshake Authentication Protocol (CHAP) 。 |
| WwanAuthProtocolMsChapV2 | 使用 Microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0。 |
IPType
指定IP類型的WWAN_IP_TYPE列舉值。
MediaPreference
ConnectionMediaSource
ActivationOption
來自 WWAN_ACTIVATION_OPTION 列舉的值，表示 MB 裝置支援的封包數據通訊協定 (PDP) 啟用選項。
Snssai
表示單一網路配量選取協助資訊 (NSSAI) 的 WWAN_SINGLE_NSSAI 結構。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT結構。 前 4 個字節是 DataBuffer 的位移，其中包含MBIM_TLV_TYPE_TRAFFIC_PARAMETERS數據欄位的原始數據，以位元組為單位，從WWAN_SET_CONTEXT_STATE開頭計算。 第二個 4 個字節是MBIM_TLV_TYPE_TRAFFIC_PARAMETERS數據欄位的原始數據大小，以位元組為單位。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 及更新版本的 Windows 中提供。 |
| 標頭 | wwan.h (包含 Wwan.h) |