DOT11EXTIHV_RECEIVE_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.

Das Betriebssystem ruft die Dot11ExtIhvReceivePacket Funktion auf, um ein Paket, das vom WLAN-Adapter (Wireless LAN) empfangen wird, zur Verarbeitung an die IHV-Erweiterungs-DLL weiterzuleiten.

Syntax

DOT11EXTIHV_RECEIVE_PACKET Dot11extihvReceivePacket;

DWORD Dot11extihvReceivePacket(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer
)
{...}

Parameter

[in, optional] hIhvExtAdapter

Das Handle, das von der IHV Extensions DLL verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.

[in] dwInBufferSize

Die Länge des empfangenen Pakets in Bytes, auf das vom pvInBuffer Parameter verwiesen wird.

[in] pvInBuffer

Ein Zeiger auf einen Puffer, der vom Betriebssystem zugewiesen wird, das die Paketdaten enthält, wie im Abschnitt "Hinweise" beschrieben.

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

Das Betriebssystem ruft die Dot11ExtIhvReceivePacket Funktion auf, wenn folgendes auftritt:

Der WLAN-Adapter empfängt ein Paket und den Native 802.11 Miniporttreiber, der den Adapter verwaltet, gibt das Paket an das Betriebssystem an.
Die IEEE EtherType des Pakets entspricht einem Eintrag in der Liste der EtherTypes, die durch die IHV Extensions DLL durch einen Aufruf an die Dot11ExtSetEtherTypeHandling Funktion.

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

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

Dot11ExtSetEtherTypeHandling-

Dot11ExtIhvInitAdapter

Freigeben über