DOT11EXT_SET_ETHERTYPE_HANDLING funzione di callback (wlanihv.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless nativa 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.

La DLL delle estensioni IHV chiama la funzione Dot11ExtSetEtherTypeHandling per eseguire le operazioni seguenti:

Configurare l'adattatore LAN wireless (WLAN) con un elenco di esenzioni di decrittografia dei pacchetti. Ogni esenzione viene applicata in base all'EtherType IEEE del pacchetto ricevuto.
Registrare con il sistema operativo per etherTypes di pacchetti ricevuti che verranno inoltrati alla DLL delle estensioni IHV tramite chiamate alla funzione Dot11ExtIhvReceivePacket IHV Handler.

Sintassi

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

Parametri

[in, optional] hDot11SvcHandle

Handle usato dal sistema operativo per fare riferimento all'adattatore WLAN. Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] uMaxBackLog

Numero massimo di pacchetti ricevuti che il sistema operativo accoda se la DLL delle estensioni IHV non viene restituita da una chiamata alla funzione Dot11ExtIhvReceivePacket IHV Handler. Quando viene raggiunto uMaxBackLog , il sistema operativo elimina il pacchetto meno recente nella coda.

[in] uNumOfExemption

Numero di voci all'interno della matrice di esenzioni per la privacy a cui fa riferimento il parametro pExemption . Un valore pari a zero disabilita le esenzioni per la privacy sulla scheda WLAN.

[in, optional] pExemption

Puntatore a una matrice di esenzioni per la privacy. Ogni voce della matrice viene formattata come DOT11_PRIVACY_EXEMPTION struttura.

[in] uNumOfRegistration

Numero di voci all'interno della matrice di registrazioni IEEE EtherType a cui fa riferimento il parametro pusRegistration . Un valore pari a zero disabilita la possibilità della DLL di estensioni IHV di ricevere eventuali pacchetti tramite chiamate alla funzione Dot11ExtIhvReceivePacket IHV Handler.

[in, optional] pusRegistration

Puntatore a una matrice di registrazioni IEEE EtherType. Ogni voce ha il valore EtherType in formato big-endian.

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

Quando si chiama la funzione Dot11ExtSetEtherTypeHandling , la DLL delle estensioni IHV deve seguire queste linee guida:

La DLL delle estensioni IHV può chiamare Dot11ExtSetEtherTypeHandling dall'interno delle chiamate a Dot11ExtIhvInitAdapter o Dot11ExtIhvPerformPreAssociate Funzioni del gestore IHV.
La DLL delle estensioni IHV non deve chiamare Dot11ExtSetEtherTypeHandling dopo aver completato correttamente l'operazione di pre-associazione tramite una chiamata a Dot11ExtPreAssociateCompletion.

Il sistema operativo viene predefinito in un elenco vuoto di esenzioni per la privacy e registrazioni di EtherType prima della chiamata della funzione Dot11ExtIhvInitAdapter IHV Handler.

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)