Condividi tramite

funzione di callback DOT11EXTIHV_RECEIVE_PACKET (wlanihv.h)

  • Articolo
importante L'interfaccia LAN wireless 802.1 1 nativa è 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 di 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 di 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.

Osservazioni

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 specificato 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 illustrate in gestione intestazione MAC 802.11
  • IEEE EtherType (2 byte)
  • Carico utile

Fabbisogno

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)

Vedere anche

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter