NDIS_STATUS_WWAN_PIN_INFO

Miniport-Treiber verwenden die NDIS_STATUS_WWAN_PIN_INFO Benachrichtigung, um auf OID-Abfrage zu reagieren und Anforderungen von OID_WWAN_PINfestzulegen.

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

Diese Benachrichtigung verwendet die NDIS_WWAN_PIN_INFO Struktur.

Bemerkungen

Miniport-Treiber sollten Informationen zur persönlichen Identitätsnummer (PERSONAL Identity Number, PIN) zurückgeben, die das MB-Gerät derzeit als Reaktion auf eine Abfrageanforderung erwartet. Miniport-Treiber sollten die Statusbenachrichtigung zurückgeben, die in den nachstehenden Abschnitten als Reaktion auf eine festgelegte Anforderung beschrieben ist.

Antworten auf WwanPinOperationEnter-Anforderungen

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

• Für erfolgreiche WwanPinOperationEnter Abfrageanforderungen müssen Miniporttreiber, wenn das MB-Gerät keine PIN mehr benötigt, uStatus- auf WWAN_STATUS_SUCCESS und PinType- auf WwanPinTypeNonefestlegen.

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

  • PIN deaktiviert oder NICHT erwartet: Für WwanPinOperationEnter Festlegen von Anforderungen, wenn die entsprechende PIN entweder deaktiviert oder derzeit nicht vom MB-Gerät erwartet wird, müssen Miniporttreiber PinType- auf WwanPinTypeNonefestlegen. 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-Wiederholung: In diesem Modus erfordert das MB-Gerät, dass die PIN erneut als AttemptsRemaining Wert für diesen bestimmten PIN-Typ erneut eingegeben werden muss. Miniporttreiber müssen PinType- auf denselben Wert wie die PinType- in NDIS_WWAN_SET_PIN festlegen.

  • PIN-Blockierung: Die PIN wird blockiert, wenn AttemptsRemaining null ist. Wenn der PIN-Entsperrvorgang nicht verfügbar ist, müssen Miniporttreiber uStatus- auf WWAN_STATUS_FAILURE und PinType- auf WwanPinTypeNonefestlegen. Alle anderen Elemente werden ignoriert.

    Hinweis Wenn das MB-Gerät PIN-Entsperrvorgänge unterstützt, sollten Miniporttreiber den Schritt zum Entsperren der PIN befolgen, um auf die Anforderung zu reagieren.

  • ENTSPERREN: Die PIN wird blockiert, wenn AttemptsRemaining null ist. Um die Blockierung der 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.

  • Blockiertes PUK: Wenn die Anzahl der fehlgeschlagenen Versuche den voreingestellten Wert für die Eingabe des WwanPinType-Xxx-PUK überschreitet, wird der PUK blockiert. Miniporttreiber müssen dies signalisieren, indem sie uStatus- auf WWAN_STATUS_FAILURE und PinType- auf WwanPinTypeNonefestlegen. Falls PUK1 blockiert ist, müssen Miniporttreiber eine NDIS_STATUS_WWAN_READY_INFO senden, wobei ReadyState auf WwanReadyStateBadSimfestgelegt ist.

Antworten auf WwanPinOperationEnable-, WwanPinOperationDisable- oder WwanPinOperationChange-Anforderungen

Wenn Miniporttreiber die NDIS_STATUS_WWAN_PIN_INFO Benachrichtigung verwenden, um auf WwanPinOperationEnable, WwanPinOperationDisableund WwanPinOperationChangezu reagieren, sollten sie die folgenden Vorgänge implementieren:

• Bei erfolgreichen Anforderungen müssen Miniporttreiber uStatus- auf WWAN_STATUS_SUCCESS festlegen. Weitere Mitglieder in WWAN_PIN_INFO finden Sie unter den folgenden Umständen.

• Miniporttreiber müssen uStatus- auf WWAN_STATUS_SUCCESS für PIN-fähige 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-Zustand WwanPinStateNone sein.

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

• Für alle anderen PINs kann der PIN-Zustand von WwanPinStateNone in WwanPinStateEnter je nach spezifischen MB-Gerätebedingungen geändert werden.

• 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 einschränkt, wenn er aktiviert ist, muss eine Anforderung zur Änderung im deaktivierten Zustand mit WWAN_STATUS_PIN_DISABLED zurückgegeben werden.

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

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

  Hinweis Wenn das MB-Gerät PIN-Entsperrvorgänge unterstützt, sollten Miniporttreiber den Schritt zum Entsperren der PIN befolgen, um auf die Anforderung zu reagieren.

• Entsperren der PIN: Die PIN wird blockiert, wenn AttemptsRemaining null ist. Um die Blockierung der PIN aufzuheben, kann das MB-Gerät ggf. eine entsprechende PUK anfordern. In diesem Fall müssen Miniporttreiber uStatus- auf WWAN_STATUS_FAILURE, PinType- auf den entsprechenden WwanPinTypeXxxPUK, PinState auf WwanPinStateEnterfestlegen und AttemptsRemaining- 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-Karte blockiert wird, müssen Miniporttreiber eine Ereignisbenachrichtigung senden, wobei ReadyState auf WwanReadyStateDeviceLockedfestgelegt ist.

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

Anforderungen

Version	Verfügbar in Windows 7 und höheren Versionen von Windows.
Kopfball	Ndis.h

Siehe auch

OID_WWAN_PIN