使用 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设备到设备连接提供解决方案，而无需无线接入点 (无线 AP) 来设置连接或使用现有Wi-Fi临时 (IBSS) 机制。
注意
临时模式在 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 - 启动与特定 Wi-Fi Direct 设备的按需连接，该设备以前已通过 Windows 配对体验配对。
- WFDUpdateDeviceVisibility - 汇报给定已安装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 的详细信息，请参阅 Windows.Networking.Proximity 命名空间中的 PeerFinder 和相关类。
相关主题
-
其他资源
-
引用
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈