Freigeben über

NDIS_STATUS_WWAN_PIN_INFO

  • Artikel

Miniporttreiber verwenden die NDIS_STATUS_WWAN_PIN_INFO-Benachrichtigung, um auf OID-Abfragen zu reagieren und Anforderungen von OID_WWAN_PIN festzulegen.

Miniport-Treiber können diese Benachrichtigung nicht verwenden, um unerwünschte Ereignisse zu senden.

Diese Benachrichtigung verwendet die NDIS_WWAN_PIN_INFO-Struktur .

Bemerkungen

Miniporttreiber sollten Informationen zur persönlichen Identitätsnummer (PIN) zurückgeben, die das MB-Gerät derzeit als Reaktion auf eine Abfrageanforderung erwartet. Miniport-Treiber sollten die status Benachrichtigung zurückgeben, die wie in den folgenden Abschnitten als Reaktion auf eine festgelegte Anforderung beschrieben ausgefüllt wird.

Reagieren auf WwanPinOperationEnter-Anforderungen

Wenn Miniporttreiber die NDIS_STATUS_WWAN_PIN_INFO-Benachrichtigung verwenden, um auf WwanPinOperationEnter-Anforderungen zu reagieren, sollten sie die folgenden Verfahren implementieren:

  • Wenn das MB-Gerät keine PIN mehr benötigt, müssen miniport-Treiber für erfolgreiche WwanPinOperationEnter-AbfrageanforderungenuStatus auf WWAN_STATUS_SUCCESS und PinType auf WwanPinTypeNone festlegen.

  • Bei fehlerhaften WwanPinOperationEnter-Anforderungen müssen Miniporttreiber uStatus auf WWAN_STATUS_FAILURE festlegen und entsprechende Daten gemäß den folgenden Details einschließen:

    • PIN deaktiviert oder PIN nicht erwartet: Für WwanPinOperationEnter-Set-Anforderungen müssen Miniporttreiber PinType auf WwanPinTypeNone festlegen, wenn die entsprechende PIN entweder deaktiviert oder derzeit nicht vom MB-Gerät erwartet wird. Alle anderen Member werden ignoriert.

    • PIN nicht unterstützt: Wenn die angegebene PIN vom MB-Gerät nicht unterstützt wird, müssen Miniporttreiber uStatus auf WWAN_STATUS_NO_DEVICE_SUPPORT festlegen.

    • PIN Retrial: In diesem Modus muss die PIN für das MB-Gerät erneut eingegeben werden, da der Wert für "AttemptsRemaining " für diesen bestimmten PIN-Typ immer noch ungleich 0 ist. Miniport-Treiber müssen PinType auf denselben Wert wie PinType in NDIS_WWAN_SET_PIN festlegen.

    • PIN-Blockierung: Die PIN wird blockiert, wenn AttemptsRemaining 0 (Null) ist. Wenn der Pin-Entsperrungsvorgang nicht verfügbar ist, müssen Miniporttreiber uStatus auf WWAN_STATUS_FAILURE und PinType auf WwanPinTypeNone festlegen. Alle anderen Member werden ignoriert.

      Hinweis Wenn das MB-Gerät PIN-Entsperrungsvorgänge unterstützt, sollten Miniporttreiber den Schritt Zum Aufheben der Blockierung der PIN befolgen, um auf die Anforderung zu reagieren.

    • PIN-Entsperrung: Die PIN wird blockiert, wenn AttemptsRemaining 0 (Null) ist. Um die PIN aufzuheben, kann das MB-Gerät ggf. einen entsprechenden PIN-Entsperrschlüssel (PUK) anfordern. In diesem Fall müssen Miniporttreiber PinType auf den entsprechenden WwanPinTypeXxxPUK mit den relevanten Details festlegen.

    • Blockierter PUK: Wenn die Anzahl der fehlgeschlagenen Tests den voreingestellten Wert für die Eingabe des WwanPinTypeXxxPUK überschreitet, wird das PUK blockiert. Miniport-Treiber müssen dies signalisieren, indem sie uStatus auf WWAN_STATUS_FAILURE und PinType auf WwanPinTypeNone festlegen. Falls PUK1 blockiert wird, müssen Miniporttreiber eine NDIS_STATUS_WWAN_READY_INFO senden, deren ReadyState auf WwanReadyStateBadSim festgelegt ist.

Reagieren auf WwanPinOperationEnable-, WwanPinOperationDisable- oder WwanPinOperationChange-Anforderungen

Wenn Miniporttreiber die NDIS_STATUS_WWAN_PIN_INFO-Benachrichtigung verwenden, um auf WwanPinOperationEnable, WwanPinOperationDisable und WwanPinOperationChange zu reagieren, sollten sie die folgenden Vorgänge implementieren:

  • Für erfolgreiche Anforderungen müssen Miniporttreiber uStatus auf WWAN_STATUS_SUCCESS festlegen. Informationen zu anderen Membern in WWAN_PIN_INFO finden Sie unter den folgenden Umständen.

  • Miniporttreiber müssen uStatus auf WWAN_STATUS_SUCCESS für PIN-Aktivierungs- und PIN-Deaktivierungsvorgänge festlegen, wenn sich die PIN bereits im angeforderten Zustand befindet. Miniporttreiber müssen PinType auf WwanPinTypeNone festlegen. Andere Member werden ignoriert.

  • Wenn ein PIN-Modus von deaktiviert in aktiviert geändert wird, sollte der PIN-Status WwanPinStateNone lauten.

  • Wenn PIN1 aktiviert ist, wird der PIN-Status zu WwanPinStateEnter, wenn der Strom an das MB-Gerät gestromt wird.

  • Bei allen anderen PINs kann sich der PIN-Status je nach mb-gerätespezifischen Bedingungen von WwanPinStateNone in WwanPinStateEnter ändern.

  • PIN nicht unterstützt: Wenn ein PIN-Vorgang vom MB-Gerät nicht unterstützt wird, müssen Miniporttreiber uStatus auf WWAN_STATUS_NO_DEVICE_SUPPORT festlegen. Beispielsweise wird das Aktivieren und Deaktivieren von PIN2 in der Regel nicht von MB-Geräten unterstützt, sodass der obige Fehlercode zurückgegeben werden muss. Alle anderen Member werden ignoriert.

  • PIN muss eingegeben werden: Wenn für einen PIN-Vorgang eine PIN eingegeben werden muss, müssen Miniporttreiber uStatus auf WWAN_STATUS_PIN_REQUIRED und PinType auf WwanPinTypeXxx festlegen. Andere Member werden ignoriert.

  • PIN-Änderungsvorgang: Wenn das MB-Gerät die Änderung des PIN-Werts nur im aktivierten Zustand einschränkt, muss eine Anforderung zur Änderung im deaktivierten Zustand mit WWAN_STATUS_PIN_DISABLED zurückgegeben werden.

  • PIN-Wiederholung: Bei einem Fehler müssen Miniporttreiber uStatus auf WWAN_STATUS_FAILURE und PinType auf den gleichen Wert festlegen, wie in NDIS_WWAN_SET_PIN angegeben. Andere Member werden mit Ausnahme von AttemptsRemaining ignoriert. Dies kann auftreten, wenn eine falsche PIN eingegeben wird.

  • PIN-Blockierung: Die PIN wird blockiert, wenn die Anzahl von AttemptsRemaining null ist. Wenn der Pin-Entsperrungsvorgang nicht verfügbar ist, müssen Miniporttreiber uStatus auf WWAN_STATUS_FAILURE und PinType auf WwanPinTypeNone festlegen. AttemptsRemaining sollte auf 0 festgelegt werden, und alle anderen Member werden ignoriert.

    Hinweis Wenn das MB-Gerät PIN-Entsperrungsvorgänge unterstützt, sollten Miniporttreiber den Schritt Zum Aufheben der Blockierung der PIN befolgen, um auf die Anforderung zu reagieren.

  • Aufheben der Blockierung der PIN: Die PIN wird blockiert, wenn AttemptsRemaining null ist. Um die PIN aufzuheben, kann das MB-Gerät ggf. ein entsprechendes PUK anfordern. In diesem Fall müssen Miniporttreiber uStatus auf WWAN_STATUS_FAILURE festlegen, PinType auf den entsprechenden WwanPinTypeXxxPUK, PinState auf WwanPinStateEnter und AttemptsRemaining sollte die Anzahl der Versuche haben, die zum Eingeben eines gültigen PUK zulässig sind.

    Wenn die PIN-Blockierung dazu führt, dass das MB-Gerät oder die SIM blockiert wird, müssen Miniporttreiber eine Ereignisbenachrichtigung senden, bei der ReadyState auf WwanReadyStateDeviceLocked festgelegt ist.

  • Wenn zum Zeitpunkt der PIN1-Blockierung ein aktiver PDP-Kontext vorhanden ist, müssen Miniporttreiber den PDP-Kontext deaktivieren und Benachrichtigungen über die PDP-Deaktivierung und die Änderung des Verbindungsstatus an das Betriebssystem senden.

Requirements (Anforderungen)

Version

Verfügbar in Windows 7 und späteren Windows-Versionen.

Header

 Ndis.h

Weitere Informationen

OID_WWAN_PIN

NDIS_STATUS_WWAN_PIN_INFO