OID_WWAN_SIGNAL_STATE

  • Articolo

OID_WWAN_SIGNAL_STATE restituisce o imposta lo stato del segnale corrente.

I driver Miniport devono elaborare e eseguire query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e inviando successivamente una notifica di stato NDIS_STATUS_WWAN_SIGNAL_STATE contenente una struttura NDIS_WWAN_SIGNAL_STATE per fornire informazioni sull'indicazione dello stato del segnale corrente mostrato all'utente finale indipendentemente dal completamento di richieste di set o query.

I chiamanti che richiedono di impostare l'indicazione dello stato del segnale corrente all'utente finale forniscono una struttura NDIS_WWAN_SET_SIGNAL_INDICATION al driver miniport con le informazioni appropriate.

Commenti

Per altre informazioni sull'uso di questo OID, vedere Operazioni di forza del segnale WWAN.

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.

In genere, lo stato del segnale deve essere indicato anziché sottoposto a polling. Tuttavia, questo OID viene reso disponibile nel caso in cui lo stato del segnale corrente debba essere determinato dal servizio MB.

Per rispondere alle richieste di query, i driver miniport devono inviare una notifica di NDIS_STATUS_WWAN_SIGNAL_STATE.

In una richiesta impostata dal servizio MB, i driver miniport devono:

  • Restituire i valori correnti per Rssi e ErrorRate nella struttura NDIS_WWAN_SIGNAL_STATE oltre a segnalare i valori assoluti per RssiInterval e RssiThreshold impostati nel driver miniport.

  • Memorizzare internamente nella cache i valori RssiInterval e/o RssiThreshold anche se il dispositivo non è attualmente registrato con alcun operatore e che qualsiasi restrizione impostata dal dispositivo nei parametri di impostazione può essere solo possibile dopo la registrazione. Il driver miniport dovrebbe provare a applicare queste impostazioni nella prossima situazione disponibile immediata.

  • Completare la richiesta correttamente, se lo stato dell'interruttore hardware e/o software è attualmente DISATTIVATo. Il driver miniport memorizza nella cache i dati della richiesta e avvia la segnalazione della forza del segnale dopo l'attivazione del commutatore.

  • Può non riuscire questa richiesta con il set di codice di errore uStatus appropriato.

I driver Miniport possono eseguire le operazioni seguenti durante l'elaborazione delle richieste di query dal servizio MB:

  • Restituire i valori correnti per Rssi e ErrorRate nella struttura NDIS_WWAN_SIGNAL_STATE oltre a segnalare i valori assoluti per RssiInterval e RssiThreshold impostati nel driver miniport.

  • Eseguire questa richiesta con il set di codice di errore uStatus appropriato.

Valori restituiti:

NDIS_STATUS_NOT_SUPPORTED

I driver miniport possono restituire questo problema per dispositivi specifici che sono consapevoli delle funzionalità del dispositivo che non supportano la forza del segnale possono non riuscire la richiesta con questo codice di errore.

Implementazione consigliata

  1. I dispositivi devono supportare le indicazioni di forza del segnale.

  2. I driver devono segnalare indicazioni di forza del segnale di almeno il 50% dell'impostazione RssiInterval in un periodo di tempo di cinque minuti.

  3. I dispositivi devono evitare di segnalare la forza del segnale negli stati seguenti:

    1. Il dispositivo non è registrato o deregisterato ed è applicabile solo per i dispositivi GSM.

    2. Lo stato effettivo della radio è OFF.

    3. Negli stati precedenti è necessario restituire una query sulla forza del segnale con i dati seguenti dal driver miniport:

      Rssi = WWAN_RSSI_UNKNOWN

      ErrorRate = WWAN_ERROR_RATE_UNKNOWN;

      RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT o ultimo valore impostato>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT o l'ultimo valore impostato>

Windows 10, versione 1903

A partire da Windows 10 versione 1903, OID_WWAN_SIGNAL_STATE è stato aggiornato alla revisione 3. Questa revisione consente all'host di eseguire query sui nuovi valori di alimentazione ricevuti del segnale di riferimento (RSRP) e Signal-to-Noise (SNR) dal driver miniport. Un driver miniport deve usare la revisione 3 di questo OID e le relative strutture di dati se il driver supporta 5G.

Per altre informazioni sul supporto della classe di dati 5G, vedere Supporto della classe di dati MB 5G.

Requisiti

Versione

Disponibile in Windows 7 e versioni successive di Windows.

Intestazione

 Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_WWAN_SET_SIGNAL_INDICATION

Operazioni di forza del segnale WWAN