OID_WWAN_PIN個人識別番号 (PIN) に関連する情報を設定または返します。
ミニポート ドライバーは、セットとクエリの要求を非同期的に処理する必要があります。最初は元の要求にNDIS_STATUS_INDICATION_REQUIREDを返し、セットまたはクエリ要求が完了したときに後で NDIS_STATUS_WWAN_PIN_INFO 状態通知を送信します。
ミニポート ドライバーは NDIS_STATUS_WWAN_PIN_INFO、主に、クエリ要求を完了するときに、MB デバイスまたはサブスクライバー ID モジュール (SIM カード) のロックを解除するために PIN が必要かどうかを示すために、PIN の種類と PIN エントリの状態情報を返す NDIS_WWAN_PIN_INFO 構造体を含む状態通知を送信する必要があります。
PIN に関連する情報を設定することを要求する呼び出し元は、MB デバイスに PIN を送信したり、PIN の設定を有効または無効にしたり、SIM の PIN を変更したりするために、ミニポート ドライバーに NDIS_WWAN_SET_PIN 構造を提供します。
備考
この OID の使用方法の詳細については、WWAN ピン操作 の を参照してください。
Windows 7 ミニポート ドライバーは、OID_WWAN_PINを使用する必要があります。 Windows 8 ミニポート ドライバーは、OID_WWAN_PIN_EXを使用する必要があります。
ミニポート ドライバーは、クエリ操作を処理するときにサブスクライバー ID モジュール (SIM カード) にアクセスできますが、プロバイダー ネットワークにアクセスしないでください。
ミニポート ドライバーの初期化プロセス中、MB サービスは PIN1 が正常にロック解除されるまで登録を続行しません (有効な場合)。
ミニポート ドライバーは、設定された要求を処理するときに、NDIS_WWAN_SET_PIN構造体の PinAction.Pin メンバーに、エンド ユーザーによって入力された PIN 値を提供します。 PIN 値が SIM カードに格納されている値と一致する場合にのみ、ミニポート ドライバーによって要求を処理する必要があります。 それ以外の場合、ミニポート ドライバーは、状態コードWWAN_STATUS_FAILUREでセット要求を失敗させる必要があります。
CDMA ベースのデバイスは、電源オン デバイス ロックを PIN1 として報告する必要があります。
サポートされているすべての PIN の種類のミニポート ドライバーは、WwanPinOperationEnter 操作をサポートする必要があります。 さらに、PIN1 がサポートされている場合、ミニポート ドライバーは、WwanPinOperationEnable 、WwanPinOperationDisable 、および WwanPinOperationChange 操作をサポートする必要があります。
PIN の種類がロックされているときに PIN の種類の PIN 無効化操作が試行された場合、ミニポート ドライバーは、WWAN_STATUS_PIN_REQUIREDで要求を失敗させるか、要求を正常に完了できます。 ミニポート ドライバーが要求を正常に完了した場合は、無効にする操作も PIN のロックを解除する必要があります。
複数の PIN のレポートが有効になっており、一度に 1 つの PIN のみを報告できる場合、ミニポート ドライバーは最初に PIN1 を報告することが期待されます。 たとえば、SubsidyLock と SIM PIN1 のレポートが有効になっている場合、PIN1 が正常に検証された後にのみ、(後続のクエリ要求で) 補助ロック PIN を報告する必要があります。
MB API では、PIN1 に加えて他の PIN もサポートされます。 ただし、Windows 接続マネージャー/GUI では PIN1 のみがサポートされるため、サード パーティ製の接続マネージャー/GUI をインストールする必要があります。
必要条件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |