OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE anger eller returnerar information om en MB-enhets radiokrafttillstånd.
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_RADIO_STATE statusmeddelande som innehåller en NDIS_WWAN_RADIO_STATE struktur som anger MB-enhetens aktuella radiokrafttillstånd oavsett om du slutför uppsättnings- eller frågebegäranden.
Uppringare som begär att ställa in MB-enhetens radiokrafttillstånd ger en NDIS_WWAN_SET_RADIO_STATE struktur till miniportdrivrutinen med lämplig information.
Mer information om hur du använder denna OID finns i MB Radio State.
Miniportdrivrutiner bör inte komma åt providernätverket eller SIM-kortet (Subscriber Identity Module) vid bearbetning av frågor eller uppsättningsåtgärder.
Miniportdrivrutiner måste behålla radiokrafttillstånd för programvara över systemomstart eller borttagning och återinsättning av enheter. Miniportdrivrutiner bör lagra enhetens programradioinformation och använda den för att ställa in enhetens radioströmtillstånd omedelbart vid varje omstart eller återinsättning av enheten. Enhetens effektiva radiokrafttillstånd bestäms baserat på kombinationen av programvaru- och maskinvaruradiokrafttillstånd enligt tabellen i WWAN_RADIO_STATE.
Om värdet är WwanRadioOnmåste miniportdrivrutinerna aktivera radioström och ange RadioState.SwRadioState medlem i WWAN_RADIO_STATE-strukturen för att WwanRadioOn. Om RadioState.HwRadioState medlem var WwanRadioOff, ska miniportdrivrutiner cachelagras denna energitillståndsinformation och se till att fysiskt aktivera radiokrafttillståndet när RadioState.HwRadioState ändringar i WwanRadioOn.
Om värdet är WwanRadioOffmåste miniportdrivrutiner inaktivera radiokrafttillståndet och ange RadioState.SwRadioState medlem till WwanRadioOff.
Se följande tabell för förväntad radiotillståndsprogrammering av miniportdrivrutiner.
giltiga kombinationer för PIN-läge och PIN-
| HwRadioState-värde | SwRadioState-värde | Övergripande radiokraftstillstånd |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
För enheter som inte tillhandahåller en maskinvaruströmbrytare måste RadioState.HwRadioState medlem i NDIS_WWAN_RADIO_STATE-strukturen alltid vara inställd på WwanRadioOn.
Från och med Windows 10 version 1703 har OID_WWAN_RADIO_STATE ytterligare specifikationer för hur ett modem som stöds av flera utförare ska hantera radiotillståndskonfiguration från operativsystemet.
Med ett modem med flera körprogram som stöds finns det energifördelar med att konfigurera radiokrafttillstånd per köre. När en executor-radio är avstängd förväntar sig operativsystemet att modemet avregistreras från nätverket och inte gör några genomsöknings- eller platsuppdateringar från det. Modemet bör ha stöd för ett radiotillstånd för varje köre som annonseras till operativsystemet så att det kan avgöra vilket maskinvarukrafttillstånd det ska vara.
Om modemet till exempel har två exekutorer och en av körapparaternas radio är avstängd medan den andra är på, kan modemet hålla RF-klientdelen påslagen för att upprätthålla registreringen på den exekutor vars radio är på men inte behöver göra genomsöknings-/pingnings-/platsuppdateringar eller andra mobiltjänster för den körtjänst som är avstängd. Om båda radioapparaterna är avstängda kan modemet stänga av sin RF-klientdel och föra den övergripande maskinvaran till ett lägre strömtillstånd. Implementeringsspecifika funktioner lämnas till varje IHV.
Version |
Finns i Windows 7 och senare versioner av Windows. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |