NDIS_WWAN_CONTEXT_STATE 構造体 (ndiswwan.h)

NDIS_WWAN_CONTEXT_STATE構造体は、MB デバイスのパケット データ プロトコル (PDP) コンテキスト状態を表します。

構文

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

メンバー

Header

NDIS_WWAN_CONTEXT_STATE構造体に関する型、リビジョン、およびサイズ情報を含むヘッダー。 MB サービスは、設定された操作のためにミニポート ドライバーにデータ構造を送信するときに、次の表に示す値を持つヘッダーを 設定 します。 ミニポート ドライバーは、MB サービスにデータ構造を送信するときに、同じ値を持つヘッダーを設定する必要があります。

ヘッダー サブメンバー	値
型	NDIS_OBJECT_TYPE_DEFAULT
リビジョン	ミニポート ドライバー Windows 8これをNDIS_WWAN_CONTEXT_STATE_REVISION_2に設定する必要があります。 Windows 7 ミニポート ドライバーは、これをNDIS_WWAN_CONTEXT_STATE_REVISION_1に設定する必要があります。
サイズ	sizeof(NDIS_WWAN_CONTEXT_STATE)

 

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

uStatus

コンテキストのアクティブ化または非アクティブ化操作の状態。 次の表に、このメンバーに使用できる値を示します。

値	意味
WWAN_STATUS_SUCCESS	コンテキストのアクティブ化または非アクティブ化に成功しました。
WWAN_STATUS_FAILURE	操作が失敗しました。 ミニポート ドライバーは、コンテキストが既にアクティブ化されている場合、この値を返すことができます。
WWAN_STATUS_PIN_REQUIRED	デバイスに PIN が必要なため、操作に失敗しました。
WWAN_STATUS_BAD_SIM	無効な SIM カードが検出されたため、操作に失敗しました。
WWAN_STATUS_SIM_NOT_INSERTED	SIM カードがデバイスに完全に挿入されていないため、操作に失敗しました。
WWAN_STATUS_NOT_INITIALIZED	デバイスが初期化中のため、操作に失敗しました。 デバイスの準備完了状態が WwanReadyStateInitialized に変わったら、操作を再試行します。

 

ミニポート ドライバーは、失敗した設定 PDP アクティブ化操作の場合にのみ、次のエラー コード (前述のエラー コードに加えて) を返すことができます。

値	意味
WWAN_STATUS_RADIO_POWER_OFF	無線が現在オフになっているため、操作に失敗しました。 このエラー コードは、OID_WWAN_CONNECT セット 要求への応答でのみ返す必要があります。 無線状態がオフの場合、ミニポート ドライバーは WWAN_STATUS_SUCCESS を使用してOID_WWAN_CONNECT クエリ 要求に応答し、現在のコンテキストの状態を WwanActivationStateDeactivated として指定する必要があります。
WWAN_STATUS_SERVICE_NOT_ACTIVATED	サブスクリプションの有効期限が切れているか、デバイスで PDP のアクティブ化が許可されていないため、操作が失敗しました。
WWAN_STATUS_PROVIDER_NOT_VISIBLE	サービス プロバイダーが現在表示されていないため、操作は失敗しました。
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS	アクティブ化されたコンテキストの最大数に達したため、操作は失敗しました。
WWAN_STATUS_INVALID_ACCESS_STRING	アクセス文字列が無効であるため、操作に失敗しました。
WWAN_STATUS_INVALID_USER_NAME_PWD	指定されたユーザー名またはパスワードが無効であるため、操作に失敗しました。 ネットワーク固有のエラー コードは、 uNwError で使用できます。
WWAN_STATUS_PACKET_SVC_DETACHED	パケット サービスがデタッチされたため、操作に失敗しました。
WWAN_STATUS_NOT_REGISTERED	PDP アクティブ化を実行するためにデバイスが登録済み状態でないため、操作は失敗しました。
WWAN_STATUS_VOICE_CALL_IN_PROGRESS	音声呼び出しが現在進行中のため、操作は失敗し、PDP アクティブ化を続行できません。 この値は、音声クラスが WwanVoiceClassSeparateVoiceData に設定されているデバイスにのみ適用されます。
WWAN_STATUS_CONTEXT_NOT_ACTIVATED	ConnectionId によって識別されるコンテキストが現在アクティブ化されているコンテキストではないので、操作は失敗しました。

ContextState

デバイスのパケット データ プロトコル (PDP) コンテキスト状態を表す書式設定された WWAN_CONTEXT_STATE オブジェクト。

要件

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

こちらもご覧ください

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE