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 メンバーをネットワーク固有のエラー コードに設定する必要があります。
ミニポート ドライバーは、ネットワークによって返されるコンテキストアクティブ化エラー コードの GSM 標準仕様で定義されている追加のエラー コードを提供できます。 たとえば、ミニポート ドライバーは、3GPP 仕様 TS 24.008 コンテキストアクティブ化エラー コード (エラー コード 8 (オペレーターによって決定された禁止) など) を 、uNwError メンバーを介して MB サービスに通信できます。 CDMA ベースのネットワーク固有のエラー コードに使用できる標準はありません。 CDMA ベースのデバイスとネットワークは、 uNwError メンバーを使用してネットワーク固有のエラー コード情報を返すことができます。

NDIS_WWAN_SET_CONTEXT_STATEに応答する場合は、このメンバーを使用して、ネットワークによって返される追加のエラー コードを指定します。

要件

要件 値
サポートされている最小のクライアント Windows 8以降のバージョンの Windows で使用できます。
Header wwan.h (Wwan.h を含む)

こちらもご覧ください

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE