次の方法で共有

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 サービスにデータ構造を送信するときに、同じ値を持つヘッダーを設定する必要があります。

Header submember 価値
種類 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 で使用できます。
ヘッダー ndiswwan.h (Ndiswwan.h を含む)

関連項目

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE