DOT11EXT_SEND_PACKET Rückruffunktion (wlanihv.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.

 

Die DLL für IHV-Erweiterungen ruft die Dot11ExtSendPacket-Funktion auf, um ein Paket über den WLAN-Adapter (Wireless LAN) zu übertragen.

Syntax

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] uPacketLen

Die Länge des vom Aufrufer zugewiesenen Puffers in Bytes, auf den der pvPacket-Parameter verweist.

[in] pvPacket

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die zu übertragenden Daten enthält, wie im Abschnitt Hinweise beschrieben.

[in, optional] hSendCompletion

Ein Handle-Wert, der das Sendepaket eindeutig identifiziert.

Wenn der WLAN-Adapter den Sendevorgang abgeschlossen hat, benachrichtigt das Betriebssystem die IHV-Erweiterungen-DLL über einen Aufruf des Dot11ExtIhvSendPacketCompletion IHV-Handlerfunktion. Bei diesem Aufruf übergibt das Betriebssystem den Handle-Wert des Pakets über den hSendCompletion-Parameter .

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Die DLL für IHV-Erweiterungen muss diese Richtlinien beim Aufrufen der Funktion Dot11ExtSendPacket befolgen.

• Das Paket, das über einen Aufruf der Dot11ExtSendPacket-Funktion gesendet wird, wird asynchron abgeschlossen. Die IHV-Erweiterungen-DLL darf den Speicher, auf den der pvPacket-Parameter verweist, erst dann freigeben, wenn Dot11ExtIhvSendPacketCompletion Die IHV-Handlerfunktion wird mit dem gleichen Handle-Wert wie der hSendCompletion-Parameter aufgerufen.
• Die IHV-Erweiterungen-DLL muss den hSendCompletion-Parameter auf einen Wert festlegen, der die Paketdaten eindeutig identifiziert, auf die vom pvPacket-Parameter verwiesen wird.

Weitere Informationen zu den IHV-Handlerfunktionen finden Sie unter Native 802.11 IHV-Handlerfunktionen.

Der Puffer, auf den von pvPacket verwiesen wird, sollte die folgenden Paketdaten enthalten, die in der Reihenfolge des Netzwerkbytes angegeben sind:

• MAC-Adresse des Ziels (6 Bytes), formatiert gemäß den Richtlinien, die in 802.11 MAC Header Management erläutert werden
• IEEE EtherType (2 Bytes)
• Nutzlast

Diese Paketdaten werden an den Miniporttreiber übergeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (include Wlanihv.h)

Weitere Informationen

Native 802.11 IHV-Handlerfunktionen

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 MAC-Headerverwaltung