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 を含む)

こちらもご覧ください

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION