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

Das Betriebssystem ruft die Dot11ExtIhvReceivePacket-Funktion auf, um ein Vom WLAN-Adapter empfangenes Paket zur Verarbeitung an die IHV Extensions 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-Erweiterungen-DLL verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] dwInBufferSize

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

[in] pvInBuffer

Ein Zeiger auf einen Vom Betriebssystem zugeordneten Puffer, der 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 in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Das Betriebssystem ruft die Dot11ExtIhvReceivePacket-Funktion auf, wenn Folgendes auftritt:

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

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

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

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter

Freigeben über