OID_WWAN_RADIO_STATE

OID_WWAN_RADIO_STATE imposta o restituisce informazioni sullo stato di alimentazione radio di un dispositivo MB.

I driver Miniport devono elaborare e eseguire query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e successivamente inviando una notifica di stato NDIS_STATUS_WWAN_RADIO_STATE contenente una struttura NDIS_WWAN_RADIO_STATE che indica lo stato di alimentazione radio corrente del dispositivo MB indipendentemente dal completamento di richieste di set o query.

I chiamanti che richiedono di impostare lo stato di alimentazione radio del dispositivo MB forniscono una struttura NDIS_WWAN_SET_RADIO_STATE al driver miniport con le informazioni appropriate.

Commenti

Per altre informazioni sull'uso di questo OID, vedere MB Radio State.

I driver Miniport non devono accedere alla rete del provider o al Modulo identità sottoscrittore (scheda SIM), durante l'elaborazione di query o operazioni impostate.

I driver miniport devono conservare gli stati di alimentazione radio software tra il riavvio del sistema o la rimozione del dispositivo e la reinserzione. I driver miniport devono archiviare le informazioni radio software del dispositivo e usarle per impostare lo stato di alimentazione radio del software del dispositivo immediatamente su ogni riavvio o reinserzione del dispositivo. Lo stato di alimentazione radio efficace del dispositivo viene deciso in base alla combinazione di stato di alimentazione software e hardware radio come per la tabella in WWAN_RADIO_STATE.

Se il valore è WwanRadioOn, i driver miniport devono attivare l'alimentazione radio e impostare il membro RadioState.SwRadioState della struttura WWAN_RADIO_STATE su WwanRadioOn. Se il membro RadioState.HwRadioState era WwanRadioOff, i driver miniport devono memorizzare nella cache queste informazioni sullo stato di alimentazione e assicurarsi di attivare fisicamente lo stato di alimentazione radio quando RadioState.HwRadioState cambia in WwanRadioOn.

Se il valore è WwanRadioOff, i driver miniport devono disattivare lo stato di alimentazione radio e impostare il membro RadioState.SwRadioState su WwanRadioOff.

Fare riferimento alla tabella seguente per la programmazione dello stato radio previsto da driver miniport.

Combinazioni valide per la modalità PIN e lo stato del PIN

Valore HwRadioState	Valore SwRadioState	Stato generale della potenza radio
WwanRadioOff	WwanRadioOff	WwanRadioOff
WwanRadioOff	WwanRadioOn	WwanRadioOff
WwanRadioOn	WwanRadioOff	WwanRadioOff
WwanRadioOn	WwanRadioOn	WwanRadioOn

Per i dispositivi che non forniscono un commutatore di alimentazione hardware, il membro RadioState.HwRadioState della struttura NDIS_WWAN_RADIO_STATE deve essere sempre impostato su WwanRadioOn.

A partire da Windows 10 versione 1703, OID_WWAN_RADIO_STATE include specifiche aggiuntive per il modo in cui un modem supportato da più executor deve gestire la configurazione dello stato radio dal sistema operativo.

Con un modem supportato da più executor, è possibile configurare lo stato di alimentazione radio per ogni executor. Quando viene disattivata la radio di un executor, il sistema operativo prevede che il modem venga deregistrato dalla rete e non tenta di eseguire alcuna analisi o aggiornamenti della posizione da esso. Il modem deve supportare uno stato radio per ogni executor che annuncia al sistema operativo in modo che possa determinare lo stato di alimentazione hardware in cui deve essere.

Ad esempio, se il modem ha due executori e una delle radio dell'executor è disattivata mentre l'altra è attiva, il modem può mantenere il front-end RF acceso per mantenere la registrazione sull'executor la cui radio è attiva, ma non deve eseguire l'analisi/ping/posizione aggiornamenti o altri servizi cellulari per l'executor disattivato. Se entrambe le radio vengono disattivate, il modem può disattivare il front-end RF e portare l'hardware generale a uno stato di alimentazione inferiore. Le specifiche dell'implementazione vengono lasciate a ogni IHV.

Requisiti

Versione	Disponibile in Windows 7 e versioni successive di Windows.
Intestazione	Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_WWAN_RADIO_STATE

NDIS_WWAN_SET_RADIO_STATE

NDIS_STATUS_WWAN_RADIO_STATE

Stato radio MB

WWAN_RADIO_STATE