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 Challenge Handshake Authentication Protocol (CHAP) v2.0 を使用します。 |
IPType
IP の種類を指定するWWAN_IP_TYPE列挙体の値。
MediaPreference
ConnectionMediaSource
ActivationOption
MB デバイスがサポートするパケット データ プロトコル (PDP) アクティブ化オプションを表す WWAN_ACTIVATION_OPTION 列挙体の値。
Snssai
単一のネットワーク スライス選択支援情報 (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 で使用できます。 |
| ヘッダー | wwan.h (Wwan.h を含む) |