DOT11EXTIHV_RECEIVE_PACKET Rückruffunktion (wlanihv.h)

  • Artikel
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