NDIS_STATUS_WWAN_PIN_INFO

Miniportstuurprogramma's gebruiken de NDIS_STATUS_WWAN_PIN_INFO-melding om te reageren op de OID-query en aanvragen van OID_WWAN_PINin te stellen.

Miniportstuurprogramma's kunnen deze melding niet gebruiken om ongevraagde gebeurtenissen te verzenden.

Deze melding maakt gebruik van de NDIS_WWAN_PIN_INFO structuur.

Opmerkingen

Miniportstuurprogramma's moeten informatie retourneren over het persoonlijke identiteitsnummer (pincode) dat het MB-apparaat momenteel verwacht als reactie op een queryaanvraag. Miniportstuurprogramma's moeten de statusmelding retourneren die is ingevuld, zoals beschreven in de onderstaande secties als reactie op een ingestelde aanvraag.

Reageren op WwanPinOperationEnter-aanvragen

Wanneer miniportstuurprogramma's de melding NDIS_STATUS_WWAN_PIN_INFO gebruiken om te reageren op WwanPinOperationEnter-aanvragen aanvragen, moeten ze deze procedures implementeren:

• Voor een geslaagde WwanPinOperationEnter queryaanvragen, moeten minipoortstuurprogramma's uStatus- instellen op WWAN_STATUS_SUCCESS en PinType- op WwanPinTypeNone-.

• Voor mislukte WwanPinOperationEnter--aanvragen moeten minipoortstuurprogramma's uStatus- instellen op WWAN_STATUS_FAILURE en toepasselijke gegevens opnemen op basis van de volgende details:

  • Pincode uitgeschakeld of pincode niet verwacht: voor WwanPinOperationEnter aanvragen instellen wanneer de bijbehorende pincode is uitgeschakeld of momenteel niet wordt verwacht door het MB-apparaat, moeten minipoortstuurprogramma's PinType- instellen op WwanPinTypeNone-. Alle andere leden worden genegeerd.

  • Pincode niet ondersteund: als de opgegeven pincode niet wordt ondersteund door het MB-apparaat, moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_NO_DEVICE_SUPPORT.

  • Pincode ophalen: In deze modus vereist het MB-apparaat dat de pincode opnieuw moet worden ingevoerd als de waarde AttemptsRemaining waarde nog steeds niet nul is voor dit specifieke type pincode. Minipoortstuurprogramma's moeten PinType- instellen op dezelfde waarde als die van PinType- in NDIS_WWAN_SET_PIN.

  • Pincode blokkeren: de pincode wordt geblokkeerd wanneer AttemptsRemaining nul is. Als de blokkering van de pincode niet beschikbaar is, moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_FAILURE en PinType- op WwanPinTypeNone-. Alle andere leden worden genegeerd.

    Opmerking Als het MB-apparaat deblokkeringsbewerkingen voor pincodes ondersteunt, moeten minipoortstuurprogramma's de stap voor het deblokkeren van de pincode volgen om te reageren op de aanvraag.

  • Pincode opheffen: de pincode wordt geblokkeerd wanneer AttemptsRemaining nul is. Als u de pincode wilt deblokkeren, kan het MB-apparaat, indien van toepassing, een bijbehorende pincode ontgrendelsleutel (PUK) aanvragen. In dit geval moeten minipoortstuurprogramma's PinType- instellen op het bijbehorende WwanPinTypeXxxPUK met de relevante details.

  • Geblokkeerde PUK: Als het aantal mislukte experimenten groter is dan de vooraf ingestelde waarde voor het invoeren van WwanPinTypeXxxPUK, wordt de PUK geblokkeerd. Minipoortstuurprogramma's moeten dit signaleren door uStatus- in te stellen op WWAN_STATUS_FAILURE en PinType- op WwanPinTypeNone. Als PUK1 wordt geblokkeerd, moeten minipoortstuurprogramma's een NDIS_STATUS_WWAN_READY_INFO verzenden met ReadyState- ingesteld op WwanReadyStateBadSim-.

Reageren op WwanPinOperationEnable, WwanPinOperationDisable of WwanPinOperationChange-aanvragen

Wanneer minipoortstuurprogramma's de melding NDIS_STATUS_WWAN_PIN_INFO gebruiken om te reageren op WwanPinOperationEnable, WwanPinOperationDisableen WwanPinOperationChange, moeten ze de volgende bewerkingen implementeren:

• Voor geslaagde aanvragen moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_SUCCESS. Zie de volgende omstandigheden voor andere leden in WWAN_PIN_INFO.

• Minipoortstuurprogramma's moeten uStatus- instellen op WWAN_STATUS_SUCCESS voor bewerkingen voor inschakelen en uitschakelen van pincodes wanneer de pincode al de aangevraagde status heeft. Minipoortstuurprogramma's moeten PinType- instellen op WwanPinTypeNone-. Andere leden worden genegeerd.

• Wanneer een pincodemodus wordt gewijzigd van uitgeschakeld in ingeschakeld, moet de pincodestatus WwanPinStateNone zijn.

• Als PIN1 is ingeschakeld, wordt de pincodestatus WwanPinStateEnter wanneer de stroom wordt gecyclusd naar het MB-apparaat.

• Voor alle andere pincodes kan de pincodestatus veranderen van WwanPinStateNone in WwanPinStateEnter, afhankelijk van de specifieke voorwaarden van het MB-apparaat.

• Pincode niet ondersteund: als een pincodebewerking niet wordt ondersteund door het MB-apparaat, moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_NO_DEVICE_SUPPORT. Het in- en uitschakelen van PIN2 wordt bijvoorbeeld meestal niet ondersteund door MB-apparaten, zodat de bovenstaande foutcode moet worden geretourneerd. Alle andere leden worden genegeerd.

• Pincode moet worden ingevoerd: als voor een pincodebewerking een pincode moet worden ingevoerd, moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_PIN_REQUIRED en PinType- op WwanPinTypeXxx. Andere leden worden genegeerd.

• Bewerking voor het wijzigen van pincodes: als het MB-apparaat de wijziging van de pincodewaarde beperkt wanneer deze de status Ingeschakeld heeft, moet een aanvraag om de status Uitgeschakeld te wijzigen worden geretourneerd met WWAN_STATUS_PIN_DISABLED.

• Pincode ophalen: bij fout moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_FAILURE en PinType- op dezelfde waarde als opgegeven in NDIS_WWAN_SET_PIN. Andere leden worden genegeerd, met uitzondering van AttemptsRemaining. Dit kan gebeuren wanneer een onjuiste pincode wordt ingevoerd.

• Pincode blokkeren: de pincode wordt geblokkeerd wanneer het aantal AttemptsRemaining nul is. Als de blokkering van de pincode niet beschikbaar is, moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_FAILURE en PinType- op WwanPinTypeNone-. AttemptsRemaining- moet worden ingesteld op 0 en alle andere leden worden genegeerd.

  Opmerking Als het MB-apparaat deblokkeringsbewerkingen voor pincodes ondersteunt, moeten minipoortstuurprogramma's de stap voor het deblokkeren van de pincode volgen om te reageren op de aanvraag.

• Blokkering van pincode opheffen: de pincode wordt geblokkeerd wanneer AttemptsRemaining nul is. Als u de pincode wilt deblokkeren, kan het MB-apparaat, indien van toepassing, een bijbehorende PUK aanvragen. In dit geval moeten minipoortstuurprogramma's uStatus instellen op WWAN_STATUS_FAILURE, PinType- op het bijbehorende WwanPinTypeXxxPUK, PinState naar WwanPinStateEnter-en AttemptsRemaining- het aantal pogingen moet hebben om een geldige PUK in te voeren.

  Als het blokkeren van pincodes resulteert in het MB-apparaat of de SIM, moeten minipoortstuurprogramma's een gebeurtenismelding verzenden met ReadyState ingesteld op WwanReadyStateDeviceLocked.

• Als er een actieve PDP-context is op het moment dat pin1 wordt geblokkeerd, moeten minipoortstuurprogramma's de PDP-context deactiveren en meldingen verzenden naar het besturingssysteem over de PDP-deactivering en wijziging van de koppelingsstatus.

Eisen

Versie	Beschikbaar in Windows 7 en nieuwere versies van Windows.
Rubriek	Ndis.h

Zie ook

OID_WWAN_PIN