WiFiDirectService クラス

定義

Wi-Fi Direct サービスを表します。 このクラスは、サービス プロバイダーとの Wi-Fi Direct Service セッションを確立するために、Wi-Fi Direct Service を使用しようとしているデバイス上のコードによって使用されます。

public ref class WiFiDirectService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectService final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectService
Public NotInheritable Class WiFiDirectService
継承
Object Platform::Object IInspectable WiFiDirectService
属性

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 で導入)

注釈

これは、グループ所有者であるデバイスを優先して 2 つのデバイスを接続することをサポートするいくつかのクラスの 1 つです。 デバイスのペアリングと、グループ所有者の基本設定が無視される原因 (およびそれを修正する方法) については、 Windows.Devices.WiFiDirect.Service トピックを参照してください。

コードは、このクラスを直接インスタンス化しません。 代わりに、コードはこのプロセスに従ってこのクラスのインスタンスを取得し、それを使用して Wi-Fi Direct Service セッションを確立します。

  1. GetSelector メソッドのいずれかを使用して、特定のサービスのクエリ文字列を取得します
  2. クエリ文字列と一致する広告主を監視する DeviceWatcher を作成します。 広告主が見つかったら、その広告主を使用するか、プログラムを使用するか、ユーザーに選択を指示するかを決定します。
  3. Seeker が目的のサービス広告主を特定したら、選択した広告主デバイスのデバイス ID を使用して静的 な FromIdAsync メソッドを呼び出します。 FromIdAsync は、要求されたデバイスで要求されたサービスの WiFiDirectService のインスタンスを取得します。
  4. WiFiDirectService.ConnectAsync を呼び出してセッションを確立します。

プロパティ

PreferGroupOwnerMode

サービス インスタンスが Direct Point to Point (P2P) グループ所有者 (GO) モード Wi-Fi 選択するかどうかを指定する値を取得または設定します。

RemoteServiceInfo

このサービス インスタンスからサービス情報 BLOB を取得します。

ServiceError

サービスへの最新の接続試行に関するエラー情報。

SessionInfo

セッションの開始時にサーバーに渡されるアプリ固有のセッション情報を取得または設定します。

SupportedConfigurationMethods

優先順に並べ替えられた、サポートされている構成方法の一覧を取得します。 コードでは 、IVector 操作を使用してリストの内容を変更します。

メソッド

ConnectAsync()

このインスタンスによって表される Wi-Fi ダイレクト サービスとのサービス セッションの確立を開始します。

ConnectAsync(String)

PIN を使用してセッションを構成し、このインスタンスによって表される Wi-Fi Direct Service を使用してサービス セッションの確立を開始します。

FromIdAsync(String)

特定のデバイス ID を持つデバイスによって提供される Wi-Fi Direct Service の WiFiDirectService インスタンスを取得する静的メソッド。

GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)

Direct Service セッション プロビジョニング情報 Wi-Fi 非同期的に取得します。

GetSelector(String)

特定のサービスの Direct Service 広告主 Wi-Fi 検索するために使用する高度なクエリ構文 (AQS) 文字列を取得します。

GetSelector(String, IBuffer)

特定のサービスの Direct Service 広告主 Wi-Fi 検索するために使用する高度なクエリ構文 (AQS) 文字列を取得します。この文字列は、広告主のサービス情報 BLOB に特定のバイト シーケンスが表示されます。

イベント

SessionDeferred

セッション要求が延期されたときに発生するイベント。 これは、要求が失敗したか拒否されたことを意味するわけではないことに注意してください。 これは、ユーザーが PIN を入力するのを待機するなど、サーバーが長い操作を実行していることを示す通知です。 このメッセージを受信するシーカーは、サーバーに操作を完了する時間を与えるために、セッション要求をタイムアウトする前に 120 秒の待機を開始する必要があります。 イベント引数には、サーバーによって提供されるバッファーが、遅延通知に追加情報と共に含まれます。

適用対象