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 ベースのネットワークの場合、これは "data.thephone-company.com" などのアクセス ポイント名 (APN) 文字列になります。 CDMA ベースのネットワークの場合、"#777" などの特殊なダイヤル コードや、"" などのfoo@thephone-company.comネットワーク アクセス識別子 (NAI) が考えられます。 このメンバーは NULL にすることができます。
文字列のサイズは 100 バイトを超えないようにしてください。
UserName[WWAN_USERNAME_LEN]
認証するユーザー名を表す NULL で終わる文字列。 このメンバーは NULL にすることができます。
Password[WWAN_PASSWORD_LEN]
ユーザー名のパスワードを表す NULL で終わる文字列。 このメンバーは NULL にすることができます。
Compression
ヘッダーとデータのデータ接続で圧縮を使用するかどうかを指定するWWAN_COMPRESSION列挙の値。 このメンバーは、GSM ベースのデバイスにのみ適用されます。 MB サービスは、このメンバーを CDMA ベースのデバイスの WwanCompressionNone に設定します。
| 値 | 意味 |
|---|---|
| WwanCompressionNone | 圧縮は適用されません。 |
| WwanCompressionEnable | ヘッダーとデータの圧縮を有効にします。 |
AuthType
PDP アクティブ化に使用する認証の種類を指定する、WWAN_AUTH_PROTOCOL列挙の値。 このメンバーは、GSM ベースのデバイスにのみ適用されます。 MB サービスは、このメンバーを CDMA ベースのデバイスの WwanAuthProtocolNone に設定します。
| 値 | 意味 |
|---|---|
| WwanAuthProtocolNone | 認証プロトコルはありません。 |
| WwanAuthProtocolPap | 暗号化されていないパスワード認証。 |
| WwanAuthProtocolChap | チャレンジ ハンドシェイク認証プロトコル (CHAP) を使用します。 |
| WwanAuthProtocolMsChapV2 | Microsoft チャレンジ ハンドシェイク認証プロトコル (CHAP) v2.0 を使用します。 |
IPType
IP の種類を指定するWWAN_IP_TYPE列挙の値。
MediaPreference
ConnectionMediaSource
ActivationOption
MB デバイスでサポートされているパケット データ プロトコル (PDP) アクティブ化オプションを表す WWAN_ACTIVATION_OPTION 列挙の値。
Snssai
1 つのネットワーク スライス選択支援情報 (NSSAI) を表す WWAN_SINGLE_NSSAI 構造体。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT構造体。 最初の 4 バイトは、WWAN_SET_CONTEXT_STATEの先頭から計算された、MBIM_TLV_TYPE_TRAFFIC_PARAMETERSデータ フィールドの生データを含む DataBuffer へのオフセットです (バイト単位)。 2 番目の 4 バイトは、MBIM_TLV_TYPE_TRAFFIC_PARAMETERS データ フィールドの生データのサイズ (バイト単位) です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8以降のバージョンの Windows で使用できます。 |
| Header | wwan.h (Wwan.h を含む) |