IMbnRadio ::SetSoftwareRadioState, méthode (mbnapi.h)

Définit l’état radio du logiciel d’un appareil haut débit mobile.

Syntaxe

HRESULT SetSoftwareRadioState(
  [in]  MBN_RADIO radioState,
  [out] ULONG     *requestID
);

Paramètres

[in] radioState

Valeur MBN_RADIO qui spécifie le nouvel état radio logiciel.

[out] requestID

Pointeur vers un ID de demande attribué par le service haut débit mobile pour identifier cette demande.

Valeur retournée

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

Remarques

SetSoftwareRadioState modifie l’état radio du logiciel de l’appareil. Il s’agit d’une opération asynchrone qui retourne immédiatement. À l’achèvement, le service haut débit mobile appelle la méthode OnSetSoftwareRadioStateComplete de l’interface IMbnRadioEvents .

La désactivation de la radio pour un appareil haut débit mobile entraîne la désactivation de toute connexion active, le détachement de paquets réseau et la désinscription du réseau. Si l’opération de radio-arrêt entraîne une modification de l’état de connexion, de l’état d’attachement de paquets ou de l’état d’inscription réseau, l’application reçoit une notification des modifications.

Lorsque la radio logicielle et matérielle est activée pour un appareil haut débit mobile, il tente automatiquement de s’inscrire au réseau. En outre, certains appareils peuvent également essayer d’effectuer une attachement de paquets au réseau. Chaque fois que l’état change, l’application appelante reçoit des notifications d’événement pour l’inscription réseau et les changements d’état d’attachement de paquets.

L’état radio d’un appareil peut changer sans demande de modification de l’application. Par instance, si un utilisateur active le commutateur radio matériel du système. Le service Haut débit mobile informe l’application d’un changement d’état radio en appelant la méthode OnRadioStateChange de l’interface IMbnRadioEvents .

Configuration requise

Voir aussi

IMbnRadio