Metodo IMbnSignal::GetSignalError (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 frequenza di errore del segnale ricevuta.
Sintassi
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
Parametri
[out, retval] signalError
Puntatore alla frequenza di errore nel segnale ricevuto.
Mobile Broadband Interfaces segnala la frequenza degli errori del segnale come valore codificato che esegue il mapping all'intervallo percentuale di percentuali di errori. Si tratta della frequenza degli errori di bit del canale per GSM e frequenza degli errori dei fotogrammi per CDMA. In entrambi i casi, MBN_ERROR_RATE_UNKNOWN specifica una frequenza di errore sconosciuta.
La tabella seguente illustra i valori per i codici di frequenza degli errori.
| Velocità di errore di bit (in %) | Frequenza degli errori di fotogrammi (in %) | Valore codificato (0-7) |
|---|---|---|
| < 0.2 | < 0.01 | 0 |
| 0.2 - 0.4 | 0.01 - 0.1 | 1 |
| 0.4 - 0.8 | 0.1 - 0.5 | 2 |
| 0.8 - 1.6 | 0.5 - 1.0 | 3 |
| 1.6 - 3.2 | 1.0 - 2.0 | 4 |
| 3.2 - 6.4 | 2.0 - 4.0 | 5 |
| 6.4 - 12.8 | 4.0 - 8.0 | 6 |
| > 12.8 | > 8.0 | 7 |
| unknown | unknown | MBN_ERROR_RATE_UNKNOWN |
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è stato completato correttamente . |
|
La frequenza degli errori non è ancora disponibile. Il servizio Mobile Broadband esegue il probe corrente del dispositivo per recuperare le informazioni. Quando è disponibile la frequenza di errore, il servizio Mobile Broadband chiamerà il metodo OnSignalStateChange di IMbnSignalEvents. |
Commenti
Le interfacce Mobile Broadband segnalano la frequenza di errore del segnale come valore codificato che esegue il mapping a un intervallo percentuale di frequenze di errore. Si tratta della frequenza degli errori di bit del canale per GSM e frequenza degli errori dei fotogrammi per CDMA. Per entrambi i casi, MBN_ERROR_RATE_UNKNOWN specifica una frequenza di errore sconosciuta.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |