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 を含む) |