OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE returnerar eller anger det aktuella signaltillståndet.
Miniportdrivrutiner måste bearbeta uppsättnings- och frågebegäranden asynkront, först returnera NDIS_STATUS_INDICATION_REQUIRED till den ursprungliga begäran och senare skicka ett NDIS_STATUS_WWAN_SIGNAL_STATE statusmeddelande som innehåller en NDIS_WWAN_SIGNAL_STATE struktur för att ge information om den aktuella signaltillståndsindikationen som visas för slutanvändaren oavsett om du slutför uppsättnings- eller frågebegäranden.
Uppringare som begär att ange den aktuella signaltillståndsindikationen till slutanvändaren tillhandahåller en NDIS_WWAN_SET_SIGNAL_INDICATION struktur till miniportdrivrutinen med lämplig information.
Anmärkningar
Mer information om hur du använder denna OID finns i WWAN Signal Strength Operations.
Miniportdrivrutiner bör inte komma åt providernätverket eller SIM-kortet (Subscriber Identity Module) vid bearbetning av frågor eller uppsättningsåtgärder.
I allmänhet bör signaltillstånd anges i stället för att avsökas. Denna OID görs dock tillgänglig om det aktuella signaltillståndet måste fastställas av MB-tjänsten.
För svar på frågebegäranden bör miniportdrivrutiner skicka ett NDIS_STATUS_WWAN_SIGNAL_STATE meddelande.
På en uppsättningsbegäran från MB-tjänsten ska miniportdrivrutiner:
Returnera de aktuella värdena för Rssi och ErrorRate i NDIS_WWAN_SIGNAL_STATE-strukturen förutom att rapportera absolutvärdena för RssiInterval och RssiThreshold- som har angetts i miniportdrivrutinen.
Cachelagrar internt RssiInterval- och/eller RssiThreshold- värden även om enheten för närvarande inte är registrerad hos någon operator och att eventuella begränsningar som införts av enheten i inställningsparametrarna bara kan vara möjliga efter registreringen. Miniportdrivrutinen bör försöka tillämpa de här inställningarna i nästa omedelbara tillgängliga situation.
Slutför begäran om läget för maskinvaru- och/eller programvaruradioväxlingen för närvarande är AV. Miniportdrivrutinen cachelagr begärandedata och börjar rapportera signalstyrkan när växeln är aktiverad.
Kan misslyckas med den här begäran med rätt uStatus felkoduppsättning.
Miniportdrivrutiner kan göra följande när du bearbetar frågebegäranden från MB-tjänsten:
Returnera de aktuella värdena för Rssi och ErrorRate i NDIS_WWAN_SIGNAL_STATE-strukturen förutom att rapportera absolutvärdena för RssiInterval och RssiThreshold- som har angetts i miniportdrivrutinen.
Den här begäran misslyckas med rätt uStatus felkoduppsättning.
Returvärden:
NDIS_STATUS_NOT_SUPPORTED
Miniportdrivrutiner kan returnera detta för specifika enheter som är medvetna om enhetsfunktioner som inte stöder signalstyrkan kan misslyckas med begäran med den här felkoden.
rekommenderad implementering
Enheterna måste ha stöd för signalstyrka.
Drivrutiner måste rapportera signalstyrka på minst 50% av inställningen RssiInterval under en tidsperiod på fem minuter.
Enheter måste undvika att rapportera signalstyrkan i följande tillstånd:
Enheten är inte registrerad eller avregistrerad och gäller endast för GSM-enheter.
Det effektiva tillståndet för radio är AV.
I ovanstående tillstånd måste en fråga till signalstyrkan returneras med följande data av miniportdrivrutinen:
Rssi = WWAN_RSSI_UNKNOWN
ErrorRate = WWAN_ERROR_RATE_UNKNOWN;
RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT eller senaste angivna värdet>
RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT eller det sista angivna värdet>
Windows 10, version 1903
Från och med Windows 10 version 1903 har OID_WWAN_SIGNAL_STATE uppgraderats till revision 3. Den här revisionen gör det möjligt för värden att köra frågor mot ny referenssignal mottagen ström (RSRP) och SNR-värden (Signal-to-Noise) från miniportdrivrutinen. En miniportdrivrutin måste använda revision 3 av denna OID och dess datastrukturer om drivrutinen stöder 5G.
Mer information om stöd för 5G-dataklass finns i MB 5G-dataklassstöd.
Krav
Version |
Finns i Windows 7 och senare versioner av Windows. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |