Поделиться через

Использование функций Wi-Fi Direct

  • Статья

В этой теме показано, как использовать функции Wi-Fi Direct в настольных приложениях. Начиная с Windows 8 и Windows Server 2012, функции Wi-Fi Direct были добавлены в Native Wifi API.

Функция Wi-Fi Direct основана на разработке одноранговой технической спецификации Wi-Fi версии 1.1 Альянсом Wi-Fi (см. опубликованные спецификации Альянса Wi-Fi). Цель Wi-Fi одноранговой технической спецификации заключается в предоставлении решения для Wi-Fi подключения между устройствами без необходимости установки беспроводной точки доступа (беспроводной точки доступа) или использования существующего механизма 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 для заданного установленного узла устройства 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, сначала необходимо, чтобы приложение получило дескриптор на службу Wi-Fi Direct, вызвав функцию WFDOpenHandle. Дескриптор Wi-Fi Direct (WFD), возвращаемый функцией WFDOpenHandle, используется для последующих вызовов функции Direct Wi-Fi, выполненных в службу 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.

Другие ресурсы

О Native Wi-Fi

О API Native Wifi

О функции Wi-Fi Direct

Справочник

PeerFinder

WFD_OPEN_SESSION_COMPLETE_CALLBACK

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

Windows.Networking.Proximity