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
単一のネットワーク スライス選択支援情報 (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 で使用できます。 |
ヘッダー | wwan.h (Wwan.h を含む) |