DOT11EXT_SEND_PACKET Rückruffunktion (wlanihv.h)

Artikel
02/27/2024

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

Freigeben über