WWAN_CONTEXT_STATE 構造体 (wwan.h)
WWAN_CONTEXT_STATE構造体は、MB デバイスのパケット データ プロトコル (PDP) コンテキストの状態を表します。
構文
typedef struct _WWAN_CONTEXT_STATE {
ULONG uNwError;
ULONG ConnectionId;
WWAN_ACTIVATION_STATE ActivationState;
WWAN_VOICE_CALL_STATE VoiceCallState;
WWAN_IP_TYPE IPType;
WWAN_CONNECTION_MEDIA ConnectionMedia;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WWAN_SINGLE_NSSAI Snssai;
ULONG FoundMatchingConnectionId;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;
メンバー
uNwError
ネットワーク固有のエラー。 次の表は、「 3GPP TS 24.008 仕様」に記載されている接続エラー値を示しています。
| 3GPP 24.008 原因コード | 原因コードの解釈 |
|---|---|
| 8 - オペレーターが判別した控えめ | パケット データ サービスは、オペレーターによってブロックされます。 |
| 26 - リソースが不足しています | ネットワーク上のリソースが不足しているため、コンテキストをアクティブ化できません。 |
| 27 - アクセス ポイント名が見つからないか不明 (APN) | アクティブ化要求に APN または不明な APN が指定されていません。 |
| 29 、30、31 - ユーザー認証に失敗しました | アクティブ化要求で指定されたユーザー名またはパスワードが正しくありません。 |
| 32 - サービス オプションはサポートされていません | GPRS はネットワークでサポートされていません。 |
| 33 - 要求されたサービス オプションがサブスクライブされていません | 要求されたサービス (GPRS) は、ユーザーによってサブスクライブされていません。 |
| 34 - サービス オプションが一時的に順序が切れている | パケット データ サービスは一時的に順序が外れている。 ユーザーは後で再試行する必要があります。 |
| 43 - 不明なパケット データ プロトコル (PDP) コンテキスト | アクティブ化要求に APN または不明な APN が指定されていません。 |
ConnectionId
MB サービスは、OID_WWAN_CONNECTを使用して、接続要求時にこのメンバーの値を指定します。 ミニポート ドライバーは、この値をコピーし、後続の接続状態の変更時に MB サービスに通知するときに使用する必要があります。
ActivationState
デバイスの現在のアクティブ化状態。
VoiceCallState
デバイスの現在の音声通話状態。
IPType
IP の種類を指定するWWAN_IP_TYPE列挙の値。
ConnectionMedia
確立されたコンテキスト/セッションのメディアの種類。
AccessString[WWAN_ACCESSSTRING_LEN]
確立されたコンテキスト/セッションに対して選択された APN/DNN。
Snssai
1 つのネットワーク スライス選択支援情報 (NSSAI) を表す WWAN_SINGLE_NSSAI 構造体。
FoundMatchingConnectionId
状態がWWAN_STATUS_SESSION_ALREADY_EXISTS場合にのみ有効です。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT構造体。 状態がWWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION場合にのみ有効です。 最初の 4 バイトは、WWAN_SET_CONTEXT_STATEの先頭から計算されたMBIM_TLV_TYPE_TRAFFIC_PARAMETERSの生データを含む DataBuffer へのオフセットです (バイト単位)。 2 番目の 4 バイトは、MBIM_TLV_TYPE_TRAFFIC_PARAMETERSの生データのサイズ (バイト単位) です。
注釈
設定 OID 要求と未承諾状態イベントは 、uNwError メンバーを使用します。 ネットワーク固有のエラーがない場合、またはネットワーク固有のエラーが不明な場合、ミニポート ドライバーはこのメンバーを 0 に設定する必要があります。
次の点では、さまざまなシナリオでネットワーク固有のエラーを返すガイドラインを示します。
- セット要求が失敗した場合、ミニポート ドライバーは、ネットワーク固有のエラー コードを返す必要があります。 この場合、ミニポート ドライバーは、NDIS_WWAN_CONTEXT_STATE構造体の uStatus メンバーをWWAN_STATUS_FAILUREに設定するか、WWAN_STAUS_INVALID_ACCESS_STRINGやWWAN_STATUS_INVALID_USER_NAME_PWDなどのより具体的なエラーを設定し、 uNwError メンバーをネットワーク固有のエラー コードに設定する必要があります。
- ネットワークによって開始されたコンテキスト非アクティブ化のためにデバイス コンテキストのアクティブ化状態が変更されるたびに、要求されていない状態イベントにネットワーク固有のエラーが含まれている必要があります。 この場合、ミニポート ドライバーは、NDIS_WWAN_CONTEXT_STATE構造体の uStatus メンバーをWWAN_STATUS_SUCCESSに設定し、 uNwError メンバーをネットワーク固有のエラー コードに設定する必要があります。
NDIS_WWAN_SET_CONTEXT_STATEに応答する場合は、このメンバーを使用して、ネットワークによって返される追加のエラー コードを指定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8以降のバージョンの Windows で使用できます。 |
| Header | wwan.h (Wwan.h を含む) |