DOT11EXTIHV_RECEIVE_PACKET funzione di callback (wlanihv.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

Il sistema operativo chiama la funzione Dot11ExtIhvReceivePacket per inoltrare un pacchetto, ricevuto dalla scheda LAN wireless (WLAN), alla DLL delle estensioni IHV per l'elaborazione.

Sintassi

DOT11EXTIHV_RECEIVE_PACKET Dot11extihvReceivePacket;

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

Parametri

[in, optional] hIhvExtAdapter

Handle utilizzato dalla DLL delle estensioni IHV per fare riferimento all'adattatore WLAN. Questo valore handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] dwInBufferSize

Lunghezza, in byte, del pacchetto ricevuto a cui fa riferimento il parametro pvInBuffer .

[in] pvInBuffer

Puntatore a un buffer allocato dal sistema operativo, che contiene i dati del pacchetto, come descritto nella sezione Osservazioni.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

Il sistema operativo chiama la funzione Dot11ExtIhvReceivePacket quando si verifica quanto segue:

L'adattatore WLAN riceve un pacchetto e il driver miniport nativo 802.11, che gestisce l'adattatore, indica il pacchetto al sistema operativo.
Ieee EtherType del pacchetto corrisponde a una voce nell'elenco di EtherTypes specificati dalla DLL delle estensioni IHV tramite una chiamata a Funzione Dot11ExtSetEtherTypeHandling .

Il buffer a cui punta pvPacket deve contenere i dati del pacchetto seguenti, specificati nell'ordine dei byte di rete:

Indirizzo MAC di destinazione (6 byte), formattato in base alle linee guida descritte in Gestione intestazioni MAC 802.11
IEEE EtherType (2 byte)
Payload

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	wlanihv.h (include Wlanihv.h)

Vedi anche

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter

Condividi tramite