Verwenden der Wi-Fi Direct-Funktionen
In diesen Themen wird gezeigt, wie Sie Wi-Fi Direct-Funktionen in Desktop-Apps verwenden. Ab Windows 8 und Windows Server 2012 wurden Wi-Fi Direct-Funktionen zur nativen WIFI-API hinzugefügt.
Das Wi-Fi Direct-Feature basiert auf der Entwicklung der Wi-Fi Peer-to-Peer Technical Specification v1.1 durch die Wi-Fi Alliance (siehe Veröffentlichte Spezifikationen der Wi-Fi Alliance). Das Ziel der Wi-Fi Peer-to-Peer Technical Specification besteht in der Bereitstellung einer Lösung für die Wi-Fi-Gerät-zu-Gerät-Konnektivität, ohne dass entweder ein Drahtloser Zugriffspunkt (Wireless Access Point, WIRELESS AP) zum Einrichten der Verbindung oder die Verwendung des vorhandenen IBSS-Mechanismus (Wi-Fi Ad-hoc) erforderlich ist.
Hinweis
Der Ad-hoc-Modus ist in zukünftigen Versionen von Windows. Verwenden Sie Windows 8.1 und Windows Server 2012 R2 stattdessen Wi-Fi Direct.
Die folgenden Funktionen unterstützen das Wi-Fi Direct-Feature.
- WFDCancelOpenSession: Gibt an, dass die App eine ausstehende WFDStartOpenSession-Funktion abbrechen möchte, die noch nicht abgeschlossen wurde.
- WFDCloseHandle: Schließt ein Handle für den Wi-Fi Direct-Dienst.
- WFDCloseSession: Schließt eine Sitzung nach einem zuvor erfolgreichen Aufruf der WFDStartOpenSession-Funktion.
- WFDOpenHandle: Öffnet ein Handle für den Wi-Fi Direct-Dienst und handelt eine Version der zu verwendenden WI-FI Direct-API aus.
- WFDOpenLegacySession: Ruft ein gespeichertes Profil für ein Wi-Fi Direct-Legacygerät ab und wendet es an.
- WFDStartOpenSession: Startet eine bedarfsbasierte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät, das zuvor über die Windows-Kopplung gekoppelt wurde.
- WFDUpdateDeviceVisibility: Aktualisiert die Gerätesichtbarkeit für die Wi-Fi Direct-Geräteadresse für einen bestimmten installierten Wi-Fi Direct-Geräteknoten.
- WFD _ OPEN _ SESSION _ COMPLETE _ CALLBACK: Definiert die Rückruffunktion, die von der WFDStartOpenSession-Funktion aufgerufen wird, wenn der WFDStartOpenSession-Vorgang abgeschlossen ist.
Für eine Desktop-App erfordert das Wi-Fi Direct-Feature, dass WLAN Direct-Geräte zuvor vom Benutzer mit der Benutzeroberfläche für Windows-Kopplungserfahrung gekoppelt werden. Sobald diese Kopplung abgeschlossen ist, wird ein Profil gespeichert, mit dem die Wi-Fi Direct-Funktionen zum Starten einer Wi-Fi Direct-Sitzung verwendet werden können, um eine Verbindung zwischen den Wi-Fi Direct-Geräten herzustellen.
Um direkt Wi-Fi verwenden zu können, muss eine App zunächst ein Handle für den Wi-Fi Direct-Dienst abrufen, indem sie die WFDOpenHandle-Funktion aufruft. Das Wi-Fi Direct-Handle (WFD), das von der WFDOpenHandle-Funktion zurückgegeben wird, wird für nachfolgende Wi-Fi Direct-Funktionsaufrufe verwendet, die an den Wi-Fi Direct-Dienst vorgenommen werden.
Die WFDStartOpenSession-Funktion startet einen asynchronen Vorgang, um eine bedarfsbasierte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät zu starten. Das Zielgerät Wi-Fi zuvor über die Kopplungserfahrung Windows gekoppelt worden sein. Nach Abschluss des asynchronen Vorgangs wird die im pfnCallback-Parameter angegebene Rückruffunktion aufgerufen.
Sobald eine Anwendung den Wi-Fi Direct-Dienst verwendet, sollte die Anwendung die WFDCloseHandle-Funktion aufrufen, um dem Wi-Fi Direct-Dienst zu signalisieren, dass die Anwendung den Dienst verwendet. Dadurch kann der Wi-Fi Direct-Dienst die von der Anwendung verwendeten Ressourcen frei geben.
Weitere Informationen zu Wi-Fi Direct für die Verwendung in Windows Store-Apps finden Sie unter PeerKlasse und verwandte Klassen im Windows. Networking.Proximity-Namespace.
Zugehörige Themen
-
Weitere Ressourcen
-
Referenz