DOT11EXT_SEND_PACKET Rückruffunktion (wlanihv.h)

Artikel
02/07/2025

Wichtige 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 driver model.

Die IHV Extensions DLL 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 Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.

[in] uPacketLen

Die Länge des vom pvPacket Parameter referenzierten Aufruferpuffers in Bytes.

[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 Handlewert, der das Sendepaket eindeutig identifiziert.

Wenn der WLAN-Adapter den Sendevorgang abgeschlossen hat, benachrichtigt das Betriebssystem die IHV Extensions DLL über einen Aufruf an den Dot11ExtIhvSendPacketCompletion IHV-Handlerfunktion. Beim Ausführen dieses Aufrufs übergibt das Betriebssystem den Handlewert des Pakets über den hSendCompletion Parameter.

Rückgabewert

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

Bemerkungen

Die IHV-Erweiterungs-DLL muss diese Richtlinien beim Aufrufen der Dot11ExtSendPacket--Funktion befolgen.

Das Paket, das über einen Aufruf des Dot11ExtSendPacket Funktion gesendet wird, wird asynchron abgeschlossen. Die IHV Extensions DLL darf den Speicher, auf den vom pvPacket Parameter verwiesen wird, nicht freigeben, bis der Parameter Dot11ExtIhvSendPacketCompletion IHV-Handlerfunktion wird mit demselben Handlewert wie der hSendCompletion-Parameter aufgerufen.
Die IHV Extensions 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 Handler Functions.

Der Puffer, auf den pvPacket verweist sollte die folgenden Paketdaten enthalten, die in der Netzwerkbytereihenfolge angegeben sind:

MAC-Zieladresse (6 Byte), gemäß den in 802.11 MAC Header Management
IEEE EtherType (2 Bytes)
Nutzlast

Diese Paketdaten werden an den Miniporttreiber übergeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

Native 802.11 IHV-Handlerfunktionen

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 MAC Header Management

Freigeben über