NDIS_STATUS_WWAN_PIN_INFO
ミニポート ドライバーは、NDIS_STATUS_WWAN_PIN_INFO 通知を使用して、OID_WWAN_PIN の OID クエリ要求とセット要求に応答します。
ミニポート ドライバーは、この通知を使用して、要求されていないイベントを送信することはできません。
この通知には、NDIS_WWAN_PIN_INFO 構造が使用されます。
解説
ミニポート ドライバーは、クエリ要求に応答して、MB デバイスが現在想定している個人識別番号 (PIN) に関する情報を返す必要があります。 ミニポート ドライバーは、セット要求に応答して、以下のセクションの説明のように入力された状態通知を返す必要があります。
WwanPinOperationEnter 要求への応答
ミニポート ドライバーは、NDIS_STATUS_WWAN_PIN_INFO 通知を使用して WwanPinOperationEnter 要求に応答する場合、これらの手順を実装する必要があります。
WwanPinOperationEnter クエリ要求が成功していて、MB デバイスが PIN を必要としなくなった場合、ミニポート ドライバーは uStatus を WWAN_STATUS_SUCCESS に設定し、PinType を WwanPinTypeNone に設定する必要があります。
WwanPinOperationEnter 要求が失敗した場合、ミニポート ドライバーは uStatus を WWAN_STATUS_FAILURE に設定し、次の詳細に従って適用可能なデータを含める必要があります。
PIN が無効または PIN が予期されていない: WwanPinOperationEnter セット要求では、対応する PIN が無効になっているか、MB デバイスで現在予期されていない場合、ミニポート ドライバーは PinType を WwanPinTypeNone に設定する必要があります。 他のすべてのメンバーは無視されます。
PIN がサポートされていない: 指定された PIN が MB デバイスでサポートされていない場合、ミニポート ドライバーは uStatus を WWAN_STATUS_NO_DEVICE_SUPPORT に設定する必要があります。
PIN 再トライアル: このモードでは、AttemptsRemaining 値がこの特定の種類の PIN に対して 0 以外であるため、MB デバイスが PIN の再入力を要求する必要があります。 ミニポート ドライバーは、PinType の値を NDIS_WWAN_SET_PIN の PinType の値と同じにする必要があります。
PIN のブロック: AttemptsRemaining が 0 の場合、PIN はブロックされます。 PIN のブロック解除操作が使用できない場合、ミニポート ドライバーは uStatus を WWAN_STATUS_FAILURE に設定し、PinType を WwanPinTypeNone に設定する必要があります。 他のすべてのメンバーは無視されます。
注: MB デバイスが PIN のブロック解除操作をサポートしている場合、ミニポート ドライバーは PIN のブロック解除手順に従って、要求に応答する必要があります。
PIN のブロック解除: AttemptsRemaining が 0 の場合、PIN はブロックされます。 PIN のブロックを解除するために、MB デバイスは対応する PIN ロック解除キー (PUK) を要求する場合があります (該当する場合)。 この場合、ミニポート ドライバーは PinType を関連する詳細と対応する WwanPinTypeXxxPUK に設定する必要があります。
ブロックされた PUK: 失敗したトライアルの回数が WwanPinTypeXxxPUK を入力するためのプリセット値を超えた場合、PUK はブロックされます。 ミニポート ドライバーは、uStatus を WWAN_STATUS_FAILURE に設定し、PinType を WwanPinTypeNone に設定することで、これを通知する必要があります。 PUK1 がブロックされている場合、ミニポート ドライバーは、ReadyState が WwanReadyStateBadSim に設定された NDIS_STATUS_WWAN_READY_INFO を送信する必要があります。
WwanPinOperationEnable、WwanPinOperationDisable、または WwanPinOperationChange 要求への応答
ミニポート ドライバーは、NDIS_STATUS_WWAN_PIN_INFO 通知を使用して WwanPinOperationEnable、WwanPinOperationDisable、および WwanPinOperationChange に応答する場合、次の操作を実装する必要があります。
要求が成功した場合、ミニポート ドライバーは uStatus を WWAN_STATUS_SUCCESS に設定する必要があります。 WWAN_PIN_INFO の他のメンバーについては、次の状況を参照してください。
ミニポート ドライバーは、PIN が既に要求された状態にある場合、PIN の有効化および無効化の操作のために uStatus を WWAN_STATUS_SUCCESS に設定する必要があります。 ミニポート ドライバーは、PinType を WwanPinTypeNone に設定する必要があります。 他のメンバーは無視されます。
PIN モードが無効から有効に変更された場合、PIN の状態は WwanPinStateNone である必要があります。
PIN1 が有効になっている場合、電源が MB デバイスに循環されると、PIN 状態は WwanPinStateEnter になります。
その他のすべての PIN では、MB デバイス固有の条件に応じて、PIN の状態が WwanPinStateNone から WwanPinStateEnter に変更される可能性があります。
PIN がサポートされていない: PIN の操作が MB デバイスでサポートされていない場合、ミニポート ドライバーは uStatus を WWAN_STATUS_NO_DEVICE_SUPPORT に設定する必要があります。 たとえば、PIN2 の有効化と無効化は通常、MB デバイスではサポートされていないため、上記のエラー コードを返す必要があります。 他のすべてのメンバーは無視されます。
PIN を入力する必要がある: PIN 操作で PIN を入力する必要がある場合、ミニポート ドライバーは uStatus を WWAN_STATUS_PIN_REQUIRED に設定し、PinType を WwanPinTypeXxx に設定する必要があります。 他のメンバーは無視されます。
PIN 変更操作: MB デバイスが有効な状態の場合にのみ PIN 値の変更を制限する場合は、無効な状態で変更する要求を WWAN_STATUS_PIN_DISABLED で返す必要があります。
PIN 再トライアル: 失敗した場合、ミニポート ドライバーは uStatus を WWAN_STATUS_FAILURE に設定し、PinType の値を NDIS_WWAN_SET_PIN で指定された値と同じに設定する必要があります。 AttemptsRemaining を除き、他のメンバーは無視されます。 これは、正しくない PIN が入力された場合に発生する可能性があります。
PIN のブロック: AttemptsRemaining の数が 0 の場合、PIN はブロックされます。 PIN のブロック解除操作が使用できない場合、ミニポート ドライバーは uStatus を WWAN_STATUS_FAILURE に設定し、PinType を WwanPinTypeNone に設定する必要があります。 AttemptsRemaining は 0 に設定する必要があり、他のすべてのメンバーは無視されます。
注: MB デバイスが PIN のブロック解除操作をサポートしている場合、ミニポート ドライバーは PIN のブロック解除手順に従って、要求に応答する必要があります。
PIN のブロック解除: AttemptsRemaining が 0 の場合、PIN はブロックされます。 PIN のブロックを解除するために、MB デバイスは対応する PUK (該当する場合) を要求する場合があります。 この場合、ミニポート ドライバーは uStatus を WWAN_STATUS_FAILURE に、PinType を対応する WwanPinTypeXxxPUK に、PinState を WwanPinStateEnter にそれぞれ設定し、AttemptsRemaining には有効な PUK を入力できる試行回数を設定する必要があります。
PIN のブロックにより、MB デバイスまたは SIM がブロックされた場合、ミニポート ドライバーは ReadyState が WwanReadyStateDeviceLocked に設定されたイベント通知を送信する必要があります。
PIN1 ブロック時にアクティブな PDP コンテキストがある場合、ミニポート ドライバーは PDP コンテキストを非アクティブ化し、PDP の非アクティブ化とリンク状態の変更に関する通知をオペレーティング システムに送信する必要があります。
要件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダー |
Ndis.h |