使用 Wi-Fi Direct 函式
本主題說明如何在傳統型應用程式中使用 Wi-Fi Direct 函式。 從 Windows 8 和 Windows Server 2012 開始，Wi-Fi Direct 函式已新增至原生 Wifi API。
Wi-Fi 直接功能是以 Wi-Fi 聯盟 Wi-Fi 點對點技術規格 v1.1 的開發為基礎（請參閱 Wi-Fi 聯盟發佈的規格）。 Wi-Fi 點對點技術規格的目標是為 Wi-Fi 裝置對裝置連線提供解決方案，而不需要無線存取點 （wireless AP） 來設定連線或使用現有的 Wi-Fi 臨機作 （IBSS） 機制。
注意
未來版本的 Windows 可能無法使用臨機作模式。 從 Windows 8.1 和 Windows Server 2012 R2 開始，請改用 Wi-Fi Direct。
下列函式支援 Wi-Fi 直接功能。
- WFDCancelOpenSession - 指出應用程式想要取消尚未完成的暫止 WFDStartOpenSession 函式。
- WFDCloseHandle - 關閉 Wi-Fi Direct 服務的控制代碼。
- WFDCloseSession - 在先前成功呼叫 WFDStartOpenSession 函式之後關閉會話。
- WFDOpenHandle - 開啟 Wi-Fi Direct 服務的句柄，並交涉要使用的 Wi-FI Direct API 版本。
- WFDOpenLegacySession - 擷取並套用 Wi-Fi Direct 舊版裝置的預存配置檔。
- WFDStartOpenSession - 啟動特定 Wi-Fi Direct 裝置的隨選連線，該裝置已經透過 Windows 配對體驗完成配對。
- WFDUpdateDeviceVisibility - 更新指定已安裝 Wi-Fi Direct 裝置節點的 Wi-Fi Direct 裝置地址的可見度。
- 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 服務的 handle。 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 服務釋放應用程式所使用的資源。
如需 Wi-Fi Direct 以用於 Windows 市集應用程式的詳細資訊，請參閱 Windows.Networking.Proximity 命名空間中的 PeerFinder 和相關類別。
相關主題
-
其他資源
-
參考