Radio クラス

リファレンス

定義

名前空間:: Windows.Devices.Radios

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

システム上の無線デバイスを表します。

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

継承: Object Platform::Object IInspectable Radio

属性: ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

コードでは、 GetRadiosAsync、 GetDeviceSelector、 FromIdAsync などのこのクラスの静的メンバーを使用して、無線のクエリを実行し、デバイス上の特定の無線を表すインスタンス化された Radio オブジェクトを取得します。

コードでは、SetStateAsync を呼び出す前に、UI スレッドから RequestAccessAsync を少なくとも 1 回呼び出す必要があることに注意してください。これは、一部のリージョンでは、一部のユーザー設定の選択肢があり、無線状態を変更しようとするとユーザーのアクセス許可が必要になるためです。この状況では、 RequestAccessAsync を呼び出すと、アプリに無線を制御するアクセス許可を付与するかどうかを確認するプロンプトがユーザーに表示されます。ユーザーのアクセス許可を必要とするデバイスでアプリが実行されていて、コードがアクセス許可を要求および受信していない場合、 SetStateAsync はユーザーのアクセス許可がないため失敗します。

プロパティ

Kind	このオブジェクトが表す無線の種類を表す列挙値を取得します。
Name	このオブジェクトによって表されるラジオの名前を取得します。
State	このオブジェクトによって表される無線の現在の状態を取得します。

メソッド

FromIdAsync(String)	Radio オブジェクトを取得する静的メソッド。メソッドは、 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync を介して見つかった 'Device.Id' を受け入れます。この手順は、GetRadiosAsync を使用して、USB Radio が失敗した場合や、Windows 10 ワークステーションで削除された場合に無線を取得するよりも信頼性が高くなります。失敗または削除された無線のこのインスタンスでは、 GetRadiosAsync は bluetooth 無線を返しません。これに対し、FindAllAsync は、FromIdAsync に渡して無線オブジェクトを取得できる有効な ID を返します。これにより、それ自体が 'Disabled' の状態であると報告されます。
GetDeviceSelector()	Windows.Devices.Enumeration.DeviceInformation.FindAllAsync および関連メソッドを使用して無線デバイスを列挙または監視するために使用される高度なクエリ構文 (AQS) 文字列を返す静的メソッド。
GetRadiosAsync()	プログラムの起動時にシステム上に存在していた無線デバイスを表す Windows.Devices.Radios.Radio オブジェクトのコレクションを取得する静的な非同期メソッド。無線の追加または削除は、後続の呼び出しでは無視されます。
RequestAccessAsync()	現在のユーザーがこのオブジェクトによって表される無線に対してどのようなアクセス権を持っているかを示す値を取得する非同期メソッド。無線にアクセスするためにユーザーのアクセス許可が必要な状況では、このメソッドはユーザーにアクセス許可を求めます。したがって、常に UI スレッドでこのメソッドを呼び出します。
SetStateAsync(RadioState)	このオブジェクトによって表される無線の状態を設定しようとする非同期操作。

イベント

StateChanged

このオブジェクトによって表されるラジオの状態変更によって発生するイベント。 USB Bluetooth 無線が削除された場合、またはオフラインになった場合、状態の変更は報告されません。

適用対象

次の方法で共有