Méthode IMbnSignal::GetSignalStrength (mbnapi.h)

Obtient la puissance du signal reçue par l’appareil.

Syntaxe

HRESULT GetSignalStrength(
  [out, retval] ULONG *signalStrength
);

Paramètres

[out, retval] signalStrength

Pointeur vers la qualité du signal reçu par l’appareil. Lorsque la puissance du signal n’est pas connue ou qu’elle n’est pas détectable par l’appareil, cette valeur est définie sur MBN_RSSI_UNKNOWN. Si cette méthode retourne une valeur autre que S_OK, ce paramètre est 0.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

GetSignalStrength signale la puissance du signal reçue par l’appareil haut débit mobile. Pour les appareils gsm, il signale la puissance du signal comme force du signal reçue dans une valeur codée. Pour les appareils CDMA, il est signalé en fonction du RSSI compensé (comptes pour le bruit) et non en fonction du RSSI brut.

Le tableau suivant contient les valeurs codées qui peuvent être retournées.

Pour les erreurs récupérables E_MBN_PIN_REQUIRED et E_MBN_RADIO_POWER_OFF, le service haut débit mobile interroge à nouveau l’appareil pour obtenir l’état du signal lorsque la condition d’erreur est terminée. Cette méthode retourne E_PENDING jusqu’à ce que l’opération de requête soit terminée. Une fois la nouvelle requête terminée, le service haut débit mobile appelle la méthode OnSignalStateChange de IMbnSignalEvents.

Spécifications

Voir aussi

IMbnSignal