Radio Clase

Definición

Espacio de nombres:

Windows.Devices.Radios

Representa un dispositivo de radio en el sistema.

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

Herencia

Object Platform::Object IInspectable Radio

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

El código usa miembros estáticos de esta clase como GetRadiosAsync, GetDeviceSelector y FromIdAsync para consultar radios y recuperar objetos radio creados en instancias que representan radios particulares en el dispositivo.

Tenga en cuenta que el código debe llamar a RequestAccessAsync al menos una vez, desde el subproceso de interfaz de usuario, antes de intentar llamar a SetStateAsync. Esto se debe a que en algunas regiones, con algunas opciones de configuración de usuario, el intento de cambiar el estado de radio requiere el permiso de usuario. En esta situación, al llamar a RequestAccessAsync se muestra al usuario un mensaje que pregunta si quiere permitir que la aplicación tenga permiso para controlar la radio. Si la aplicación se ejecuta en un dispositivo que requiere permiso de usuario y el código no ha solicitado y recibido permiso, SetStateAsync producirá un error por falta de permiso de usuario.

Propiedades

Kind	Obtiene un valor de enumeración que describe el tipo de radio que representa este objeto.
Name	Obtiene el nombre de la radio representada por este objeto.
State	Obtiene el estado actual de la radio representada por este objeto.

Métodos

FromIdAsync(String)	Método estático que recupera un objeto Radio . El método acepta el "Device.Id" encontrado a través de Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. Este procedimiento es más confiable que usar GetRadiosAsync para obtener una radio en situaciones en las que se ha producido un error en una radio USB o se ha quitado en una estación de trabajo de Windows 10. En este caso de una radio errónea o eliminada, GetRadiosAsync no devuelve ninguna radio bluetooth. FindAllAsync, en cambio, devuelve un identificador válido que se puede pasar a FromIdAsync para obtener el objeto de radio, que se notificará como ahora en el estado de "Disabled".
GetDeviceSelector()	Método estático que devuelve una cadena de sintaxis de consulta avanzada (AQS) que se usará para enumerar o supervisar dispositivos radio con Windows.Devices.Enumeration.DeviceInformation.FindAllAsync y métodos relacionados.
GetRadiosAsync()	Método estático y asincrónico que recupera una colección de objetos Windows.Devices.Radios.Radio que representan dispositivos de radio que existían en el sistema en el momento en que se inició el programa. Las adiciones o eliminaciones de radios se omiten mediante llamadas posteriores.
RequestAccessAsync()	Método asincrónico que recupera un valor que indica qué acceso tiene el usuario actual a la radio representada por este objeto. En circunstancias en las que se requiere permiso de usuario para acceder a la radio, este método solicita al usuario permiso. Por lo tanto, llame siempre a este método en el subproceso de la interfaz de usuario.
SetStateAsync(RadioState)	Operación asincrónica que intenta establecer el estado de la radio representada por este objeto.

Eventos

StateChanged

Evento generado por un cambio de estado en la radio representada por este objeto. Cuando se quita una radio Bluetooth USB o se queda sin conexión, no se notifica ningún cambio de estado.