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

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

  • Статья

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

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

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

О собственном Wi-Fi

Сведения об API Нативного Wi-Fi

Сведения о функции Wi-Fi Direct

Справочные материалы

PeerFinder

WFD_OPEN_SESSION_COMPLETE_CALLBACK

WFDCancelOpenSession

WFDCloseHandle

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

Windows.Networking.Proximity