Radio Classe

Définition

Espace de noms:

Windows.Devices.Radios

Représente un périphérique radio sur le système.

public ref class Radio sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class Radio final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class Radio

Public NotInheritable Class Radio

Héritage

Object Platform::Object IInspectable Radio

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Votre code utilise des membres statiques de cette classe comme GetRadiosAsync, GetDeviceSelector et FromIdAsync pour rechercher des radios et récupérer des objets Radio instanciés représentant des radios particulières sur l’appareil.

Notez que votre code doit appeler RequestAccessAsync au moins une fois, à partir du thread d’interface utilisateur, avant d’essayer d’appeler SetStateAsync. En effet, dans certaines régions, avec certains choix de paramètres utilisateur, la tentative de modification de l’état radio nécessite l’autorisation de l’utilisateur. Dans ce cas, l’appel de RequestAccessAsync affiche à l’utilisateur une invite lui demandant s’il souhaite autoriser votre application à contrôler la radio. Si votre application s’exécute sur un appareil qui nécessite l’autorisation de l’utilisateur et que votre code n’a pas demandé et reçu l’autorisation, SetStateAsync échoue en cas d’absence d’autorisation utilisateur.

Propriétés

Kind	Obtient une valeur d’énumération qui décrit le type de radio que cet objet représente.
Name	Obtient le nom de la radio représentée par cet objet.
State	Obtient l’état actuel de la radio représentée par cet objet.

Méthodes

FromIdAsync(String)	Méthode statique qui récupère un objet Radio . La méthode accepte le « Device.Id » trouvé via Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. Cette procédure est plus fiable que l’utilisation de GetRadiosAsync pour obtenir une radio dans les situations où une radio USB a échoué ou a été supprimée sur une station de travail Windows 10. Dans cette instance d’une radio ayant échoué ou supprimée, GetRadiosAsync ne retourne aucune radio Bluetooth. FindAllAsync, en revanche, retourne un ID valide qui peut être transmis à FromIdAsync pour obtenir l’objet radio, qui se signale comme étant maintenant à l’état « Désactivé ».
GetDeviceSelector()	Méthode statique qui renvoie une chaîne AQS (Advanced Query Syntax) à utiliser pour énumérer ou surveiller des appareils Radio avec Windows.Devices.Enumeration.DeviceInformation.FindAllAsync et les méthodes associées.
GetRadiosAsync()	Méthode statique et asynchrone qui récupère une collection d’objets Windows.Devices.Radios.Radio représentant des appareils radio qui existaient sur le système au moment du lancement du programme. Les ajouts ou suppressions de radios sont ignorés par les appels suivants.
RequestAccessAsync()	Méthode asynchrone qui récupère une valeur indiquant l’accès de l’utilisateur actuel à la radio représentée par cet objet. Dans les cas où l’autorisation de l’utilisateur est requise pour accéder à la radio, cette méthode invite l’utilisateur à l’autoriser. Par conséquent, appelez toujours cette méthode sur le thread d’interface utilisateur.
SetStateAsync(RadioState)	Opération asynchrone qui tente de définir l’état de la radio représentée par cet objet.

Événements

StateChanged

Événement déclenché par un changement d’état dans la radio représentée par cet objet. Lorsqu’une radio Bluetooth USB est supprimée ou hors connexion, aucun changement d’état n’est signalé.