Metodo IMbnSignal::GetSignalStrength (mbnapi.h)
Importante
A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.
Ottiene la forza del segnale ricevuta dal dispositivo.
Sintassi
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
Parametri
[out, retval] signalStrength
Puntatore alla qualità del segnale ricevuta dal dispositivo. Quando la forza del segnale non è nota o non è rilevabile dal dispositivo, questa opzione è impostata su MBN_RSSI_UNKNOWN. Se questo metodo restituisce qualsiasi valore diverso da S_OK, questo parametro è 0.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
La qualità del segnale non è disponibile. Il servizio Mobile Broadband sta attualmente verificando il dispositivo per recuperare queste informazioni. Quando la qualità del segnale è disponibile, il servizio Mobile Broadband chiamerà il metodo OnSignalStateChange di IMbnSignalEvents. |
Commenti
GetSignalStrength segnala la forza del segnale ricevuta dal dispositivo Mobile Broadband. Per i dispositivi basati su GSM segnala la forza del segnale come forza di segnale ricevuta in un valore codificato. Per i dispositivi CDMA viene segnalato in base all'RSSI compensato (account per il rumore) e non basato su RSSI non elaborati.
La tabella seguente contiene i valori codificati che possono essere restituiti.
| Forza segnale (in dBm) | Valore codificato (min: 0 max: 31) |
|---|---|
| -113 o minore | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 o versione successiva | 31 |
| Sconosciuto o non rilevabile | MBN_RSSI_UNKNOWN |
Per gli errori recuperabili E_MBN_PIN_REQUIRED e E_MBN_RADIO_POWER_OFF, il servizio Mobile Broadband eseguirà nuovamente una query sul dispositivo per lo stato del segnale quando la condizione di errore è finita. Questo metodo restituirà E_PENDING fino al completamento dell'operazione di query. Al termine della nuova query, il servizio Mobile Broadband chiamerà il metodo OnSignalStateChange di IMbnSignalEvents.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |