OID_WWAN_READY_INFO
OID_WWAN_READY_INFO は、加入者識別モジュール (SIM カード) を含むデバイスの準備完了状態を返します。 これは通常、任意のセッションの開始時に発生します。
set 要求はサポートされていません。
デバイスがデュアル SIM スロットを備えている場合、ホストはデバイス内のアクティブまたは非アクティブな SIM スロットのいずれかから、準備完了状態を照会することができます。 この OID のペイロードには、UICC スロット ID を指定するWWAN_QUERY_READY_INFO構造体を含むNDIS_WWAN_QUERY_READY_INFO構造体が含まれています。
ミニポートドライバーは、query 要求を非同期に処理する必要があります。最初に元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で、query 要求の完了時に MB デバイスの準備完了状態を示す NDIS_WWAN_READY_INFO 構造体を含む NDIS_STATUS_WWAN_READY_INFO 状態通知を送信します。
解説
この OID の使用方法の詳細については、MB デバイスの準備状況を参照してください。
query 操作を処理する場合、ミニポート ドライバーはデバイス メモリまたは SIM カードにアクセスできますが、プロバイダー ネットワークにはアクセスできません。
ミニポート ドライバーは、PIN がクリアされるまで待機し (必要な場合)、加入者識別番号と電話番号 (TN) を読み取り、NDIS_WWAN_READY_INFO 構造体の ReadyInfo.ReadyState メンバーを WwanReadyStateInitialized に設定する必要があります。
ミニポート ドライバーは、OID_WWAN_READY_INFO を失敗させず、常に正しいデバイスの準備完了状態を返す必要があります。
ミニポート ドライバーは、デバイスの準備完了状態が変更されるたびに、常に MB サービスに通知する必要があります。
ミニポート ドライバーは、優れたユーザー エクスペリエンスを提供するために次の手順に従う必要があります:
PIN1 がロックされている場合、ミニポート ドライバーはまず、ReadyInfo.ReadyState を WwanReadyStateDeviceLockedに設定して、準備完了状態イベント通知を送信する必要があります。 次に MB サービスは、ミニポート ドライバーに、OID_WWAN_PIN の OID set 要求を送信します。 デバイスのロックを解除した後、ミニポート ドライバーは、WwanReadyStateInitializedに設定されたReadyInfo.ReadyStateで別の準備完了状態イベント通知を送信する必要があります。 ミニポート ドライバーは、PIN1 が正常にロック解除されるまで、デバイスの準備完了状態をWwanReadyStateInitializedに変更することはできません。
ミニポート ドライバーは、SIM カードが存在しない場合に MB サービスがミニポート ドライバーを読み込むとき、SIM カードの挿入と取り外しが可能なデバイスの場合と同様に、まず ReadyInfo.ReadyStateをWwanReadyStateSimNotInsertedに設定してイベント通知を送信する必要があります。 デバイスに SIM カードのホット 挿入を検出する機能がある場合、ミニポート ドライバーは、ユーザーが SIM を挿入したときに、ReadyInfo.ReadyStateがWwanReadyStateInitializedに設定された別のイベント通知を送信する必要があります。
サービスのアクティブ化状態を検出する機能を持つデバイスでは、ReadyInfo.ReadyStateをWwanReadyStateNotActivatedに設定する必要があります。 さらに、ミニポート ドライバーがサービスのアクティブ化をサポートしている場合、ミニポート ドライバーは、OID_WWAN_SERVICE_ACTIVATION の OID set 要求を受信します。 サービスのアクティブ化が正常に完了した場合、ミニポート ドライバーは、ReadyInfo.ReadyStateをWwanReadyStateInitializedに設定して別のイベント通知を送信する必要があります。
特定のファームウェアのリビジョンを必要とするミニポート ドライバーは、正しいファームウェアのリビジョンが使用可能であることを確認する必要があります。 ファームウェアのリビジョンが使用できない場合、ミニポート ドライバーは、ReadyInfo.ReadyStateをWwanReadyStateFailureに設定して、イベント通知トランザクションを完了する必要があります。
要件
バージョン: Windows 7 以降のバージョンの Windows で使用できます。
ヘッダー: Ntddndis.h (Ndis.h を含む)