OID_WWAN_SIGNAL_STATE

OID_WWAN_SIGNAL_STATE retourneert of stelt de huidige signaalstatus in.

Miniportstuurprogramma's moeten asynchroon set- en queryaanvragen verwerken, in eerste instantie NDIS_STATUS_INDICATION_REQUIRED retourneren naar de oorspronkelijke aanvraag en later een NDIS_STATUS_WWAN_SIGNAL_STATE statusmelding verzenden met een NDIS_WWAN_SIGNAL_STATE structuur om informatie te verstrekken over de huidige signaalstatusindicatie die wordt weergegeven aan de eindgebruiker, ongeacht het voltooien van set- of queryaanvragen.

Bellers die vragen om de huidige signaalstatusindicatie in te stellen aan de eindgebruiker, geven een NDIS_WWAN_SET_SIGNAL_INDICATION structuur aan het minipoortstuurprogramma met de juiste informatie.

Opmerkingen

Zie WWAN Signal Strength Operationsvoor meer informatie over het gebruik van deze OID.

Minipoortstuurprogramma's mogen geen toegang hebben tot het providernetwerk of de SIM-kaart (Subscriber Identity Module), bij het verwerken van query- of setbewerkingen.

Over het algemeen moet de signaalstatus worden aangegeven in plaats van gepeild. Deze OID wordt echter beschikbaar gesteld voor het geval de huidige signaalstatus moet worden bepaald door de MB-service.

Voor reactie op queryaanvragen moeten minipoortstuurprogramma's een NDIS_STATUS_WWAN_SIGNAL_STATE melding verzenden.

Bij een ingestelde aanvraag van de MB-service moeten minipoortstuurprogramma's het volgende doen:

• Retourneer de huidige waarden voor Rssi- en ErrorRate- in de NDIS_WWAN_SIGNAL_STATE structuur, naast het rapporteren van de absolute waarden voor RssiInterval- en RssiThreshold- die is ingesteld in het minipoortstuurprogramma.

• Cache intern de RssiInterval en/of RssiThreshold waarden, zelfs als het apparaat momenteel niet is geregistreerd bij een operator en dat elke beperking die door het apparaat in de instellingsparameters wordt opgelegd, alleen mogelijk is na registratie. Het minipoortstuurprogramma moet proberen deze instellingen toe te passen in de volgende onmiddellijke beschikbare situatie.

• Voltooi de aanvraag als de status van de hardware- en/of softwareschakelaar momenteel is uitgeschakeld. Miniportstuurprogramma slaat de aanvraaggegevens in de cache op en begint met het rapporteren van de signaalsterkte nadat de schakelaar is ingeschakeld.

• Kan deze aanvraag mislukken met de juiste uStatus foutcodeset.

Miniportstuurprogramma's kunnen het volgende doen bij het verwerken van queryaanvragen van de MB-service:

• Retourneer de huidige waarden voor Rssi- en ErrorRate- in de NDIS_WWAN_SIGNAL_STATE structuur, naast het rapporteren van de absolute waarden voor RssiInterval- en RssiThreshold- die is ingesteld in het minipoortstuurprogramma.

• Mislukt deze aanvraag met de juiste uStatus foutcodeset.

Retourwaarden:

NDIS_STATUS_NOT_SUPPORTED

Miniportstuurprogramma's kunnen dit retourneren voor specifieke apparaten die op de hoogte zijn van apparaatmogelijkheden die de signaalsterkte niet ondersteunen, kunnen de aanvraag mislukken met deze foutcode.

aanbevolen implementatie

1. Apparaten moeten signaalsterkte-indicaties ondersteunen.

2. Stuurprogramma's moeten signaalsterkte-indicaties van ten minste 50% van de RssiInterval instelling rapporteren gedurende een periode van vijf minuten.

3. Apparaten moeten voorkomen dat de signaalsterkte in de volgende toestanden wordt gerapporteerd:

   1. Het apparaat is niet geregistreerd of niet geregistreerd en is alleen van toepassing op GSM-apparaten.

   2. Effectieve status van radio is UITGESCHAKELD.

   3. In de bovenstaande toestanden moet een query naar de signaalsterkte worden geretourneerd met de volgende gegevens door het minipoortstuurprogramma:

      Rssi = WWAN_RSSI_UNKNOWN

      ErrorRate = WWAN_ERROR_RATE_UNKNOWN;

      RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT of laatst ingestelde waarde>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT of de laatste ingestelde waarde>

Windows 10, versie 1903

Vanaf Windows 10 versie 1903 is OID_WWAN_SIGNAL_STATE bijgewerkt naar revisie 3. Met deze revisie kan de host een query uitvoeren op nieuwe referentiesignaal ontvangen macht (RSRP) en SNR-waarden (Signal-to-Noise) van het minipoortstuurprogramma. Een minipoortstuurprogramma moet revisie 3 van deze OID en de bijbehorende gegevensstructuren gebruiken als het stuurprogramma 5G ondersteunt.

Zie MB 5G-gegevensklasse ondersteuningvoor meer informatie over ondersteuning van 5G-gegevensklassen.

Eisen

Versie	Beschikbaar in Windows 7 en nieuwere versies van Windows.
Rubriek	Ntddndis.h (inclusief Ndis.h)

Zie ook

NDIS_WWAN_SET_SIGNAL_INDICATION

WWAN Signaalsterktebewerkingen