次の方法で共有


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

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

必要条件

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

関連項目

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE