Wi-Fi Direct 関数の使用
このトピックでは、デスクトップ アプリで Wi-Fi Direct 関数を使用する方法について説明します。 Windows 8とWindows Server 2012以降、Wi-Fi Direct 関数が Native Wifi API に追加されました。
Wi-Fi Direct 機能は、Wi-Fi Alliance による Wi-Fi ピア ツー ピア技術仕様 v1.1 の開発に基づいています ( 「Wi-Fi Alliance 公開仕様」を参照)。 Wi-Fiピア ツー ピア技術仕様の目的は、ワイヤレス アクセス ポイント (ワイヤレス AP) を使用して接続をセットアップしたり、既存のWi-Fi アドホック (IBSS) メカニズムを使用したりすることなく、デバイス間接続をWi-Fiするためのソリューションを提供することです。
注意
アドホック モードは、今後のバージョンの Windows では使用できない場合があります。 Windows 8.1 および Windows Server 2012 R2 以降では、代わりに Wi-Fi Direct を使用します。
次の関数は、Wi-Fi Direct 機能をサポートしています。
- WFDCancelOpenSession - アプリが完了していない保留中の WFDStartOpenSession 関数を取り消す必要があることを示します。
- WFDCloseHandle - Wi-Fi Direct サービスへのハンドルを閉じます。
- WFDCloseSession - WFDStartOpenSession 関数を以前に正常に呼び出した後にセッションを閉じます。
- WFDOpenHandle - Wi-Fi Direct サービスへのハンドルを開き、使用する Wi-FI Direct API のバージョンをネゴシエートします。
- WFDOpenLegacySession - Wi-Fi Direct レガシ デバイスの格納されたプロファイルを取得して適用します。
- WFDStartOpenSession - Windows ペアリング エクスペリエンスを通じて以前にペアリングされた特定のWi-Fi Direct デバイスへのオンデマンド接続を開始します。
- WFDUpdateDeviceVisibility - 更新 Direct デバイス ノードにインストールされている特定のWi-Fi Direct デバイス アドレスのデバイスの可視性Wi-Fiします。
- WFD_OPEN_SESSION_COMPLETE_CALLBACK - WFDStartOpenSession 操作が完了したときに WFDStartOpenSession 関数によって呼び出されるコールバック関数 を 定義します
デスクトップ アプリの場合、Wi-Fi Direct 機能では、Wi-FI Direct デバイスを Windows ペアリング エクスペリエンス ユーザー インターフェイスとユーザーが以前にペアリングする必要があります。 このペアリングが完了すると、Wi-Fi Direct デバイス間の接続を確立するために、Wi-Fi Direct セッションを開始するためにWi-Fi Direct 関数を使用できるプロファイルが格納されます。
Wi-Fi Direct を使用するには、アプリはまず WFDOpenHandle 関数を呼び出して、Wi-Fi Direct サービスへのハンドルを取得する必要があります。 WFDOpenHandle 関数によって返される Wi-Fi Direct (WFD) ハンドルは、Wi-Fi Direct サービスに対して行われる後続Wi-Fi Direct 関数呼び出しに使用されます。
WFDStartOpenSession 関数は、特定のWi-Fi Direct デバイスへのオンデマンド接続を開始する非同期操作を開始します。 ターゲット Wi-Fi デバイスは、以前に Windows ペアリング エクスペリエンスを通じてペアリングされている必要があります。 非同期操作が完了すると、 pfnCallback パラメーターで指定されたコールバック関数が呼び出されます。
Wi-Fi Direct サービスを使用してアプリケーションが完了したら、アプリケーションは WFDCloseHandle 関数を呼び出して、アプリケーションがサービスを使用して実行されたことをWi-Fi Direct サービスに通知する必要があります。 これにより、Wi-Fi Direct サービスは、アプリケーションで使用されるリソースを解放できます。
Windows ストア アプリで使用Wi-Fi Direct の詳細については、「 PeerFinder と Windows.Networking.Proximity 名前空間の関連クラス」を参照してください。
関連トピック
-
その他のリソース
-
参照