Korzystanie z funkcji Wi-Fi Direct
W tym temacie pokazano, jak używać funkcji Wi-Fi Direct w aplikacjach na komputery stacjonarne. Począwszy od systemu Windows 8 i Windows Server 2012, funkcje Wi-Fi Direct zostały dodane do natywnego interfejsu API sieci Wi-Fi.
Funkcja Wi-Fi Direct opiera się na opracowywaniu technicznej specyfikacji Wi-Fi Peer-to-Peer w wersji 1.1 przez Wi-Fi Alliance (zobacz Wi-Fi Alliance Published Specifications). Celem specyfikacji technicznej Wi-Fi peer-to-peer jest zapewnienie rozwiązania umożliwiającego Wi-Fi łączność między urządzeniami bez konieczności konfiguracji połączenia przez bezprzewodowy punkt dostępu (AP) lub korzystania z istniejącego mechanizmu Wi-Fi ad hoc (IBSS).
Notatka
Tryb ad hoc może nie być dostępny w przyszłych wersjach systemu Windows. Począwszy od systemów Windows 8.1 i Windows Server 2012 R2, zamiast tego użyj Wi-Fi Direct.
Następujące funkcje obsługują funkcję Wi-Fi Direct.
- WFDCancelOpenSession — wskazuje, że aplikacja chce anulować oczekującą funkcję WFDStartOpenSession, która nie została ukończona.
- WFDCloseHandle — zamyka dojście do usługi Wi-Fi Direct.
- WFDCloseSession — zamyka sesję po wcześniejszym pomyślnym wywołaniu funkcji WFDStartOpenSession.
- WFDOpenHandle — otwiera dojście do usługi Wi-Fi Direct i negocjuje wersję interfejsu API Wi-FI Direct do użycia.
- WFDOpenLegacySession — pobiera i stosuje zapisany profil dla urządzenia starszego typu Wi-Fi Direct.
- WFDStartOpenSession — uruchamia połączenie na żądanie z określonym urządzeniem Wi-Fi Direct, które zostało wcześniej sparowane za pośrednictwem środowiska parowania systemu Windows.
- WFDUpdateDeviceVisibility — aktualizuje widoczność urządzenia dla adresu urządzenia Wi-Fi Direct dla danego zainstalowanego węzła urządzenia Wi-Fi Direct.
- WFD_OPEN_SESSION_COMPLETE_CALLBACK — definiuje funkcję wywołania zwrotnego, która jest wywoływana przez funkcję WFDStartOpenSession, gdy operacja WFDStartOpenSession zostanie zakończona.
W przypadku aplikacji komputerowej funkcja Wi-Fi Direct wymaga, aby urządzenia Wi-FI Direct zostały wcześniej sparowane przez użytkownika z interfejsem parowania systemu Windows. Po zakończeniu parowania profil jest przechowywany, który umożliwia używanie funkcji Wi-Fi Direct do uruchamiania sesji Wi-Fi Direct w celu nawiązania połączenia między urządzeniami Wi-Fi Direct.
Aby można było używać Wi-Fi Direct, aplikacja musi najpierw uzyskać dojście do usługi Wi-Fi Direct, wywołując funkcję WFDOpenHandle. Uchwyt Wi-Fi Direct (WFD) zwrócony przez funkcję WFDOpenHandle jest używany do późniejszych wywołań funkcji Wi-Fi Direct realizowanych przez usługę Wi-Fi Direct.
Funkcja WFDStartOpenSession uruchamia operację asynchroniczną w celu uruchomienia połączenia na żądanie z określonym urządzeniem Wi-Fi Direct. Urządzenie docelowe Wi-Fi musi wcześniej zostać sparowane przy użyciu opcji parowania systemu Windows. Po zakończeniu operacji asynchronicznej wywoływana jest funkcja wywołania zwrotnego określona w parametrze pfnCallback.
Po zakończeniu korzystania z usługi Wi-Fi Direct aplikacja powinna wywołać funkcję WFDCloseHandle, aby zasygnalizować usłudze Wi-Fi Direct, że korzystanie z usługi zostało zakończone. Dzięki temu usługa Wi-Fi Direct może zwolnić zasoby używane przez aplikację.
Aby uzyskać więcej informacji o Wi-Fi Direct wykorzystywanym w aplikacjach Sklepu Windows, zobacz PeerFinder oraz powiązane klasy w przestrzeni nazw Windows.Networking.Proximity.
Tematy pokrewne
-
Inne zasoby
-
Odniesienie