DOT11EXT_SET_ETHERTYPE_HANDLING función de devolución de llamada (wlanihv.h)

Artículo
02/27/2024

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

El archivo DLL de extensiones de IHV llama a la función Dot11ExtSetEtherTypeHandling para hacer lo siguiente:

Configure el adaptador LAN inalámbrico (WLAN) con una lista de exenciones de descifrado de paquetes. Cada exención se aplica en función del IEEE EtherType del paquete recibido.
Regístrese con el sistema operativo para los EtherTypes de paquetes recibidos que se reenviarán a IHV Extensions DLL a través de llamadas a la función Dot11ExtIhvReceivePacket IHV Handler.

Sintaxis

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
)
{...}

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador WLAN. Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.

[in] uMaxBackLog

El número máximo de paquetes recibidos que el sistema operativo pone en cola si el archivo DLL de extensiones IHV no ha devuelto de una llamada a la función Dot11ExtIhvReceivePacket IHV Handler. Cuando se alcanza uMaxBackLog , el sistema operativo descarta el paquete más antiguo de la cola.

[in] uNumOfExemption

Número de entradas dentro de la matriz de exenciones de privacidad a las que hace referencia el parámetro pExemption . Un valor de cero deshabilita las exenciones de privacidad en el adaptador WLAN.

[in, optional] pExemption

Puntero a una matriz de exenciones de privacidad. Cada entrada de la matriz tiene el formato DOT11_PRIVACY_EXEMPTION estructura.

[in] uNumOfRegistration

Número de entradas dentro de la matriz de registros IEEE EtherType a la que hace referencia el parámetro pusRegistration . Un valor de cero deshabilita la capacidad de la DLL de extensiones IHV para recibir los paquetes a través de llamadas a la función de controlador IHV Dot11ExtIhvReceivePacket .

[in, optional] pusRegistration

Puntero a una matriz de registros IEEE EtherType. Cada entrada tiene el valor EtherType en formato big-endian.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

Al llamar a la función Dot11ExtSetEtherTypeHandling , el archivo DLL de extensiones IHV debe seguir estas instrucciones:

El archivo DLL de extensiones de IHV puede llamar a Dot11ExtSetEtherTypeHandling desde las llamadas a Dot11ExtIhvInitAdapter o Dot11ExtIhvPerformPreAssociate Funciones de controlador de IHV.
El archivo DLL de extensiones de IHV no debe llamar a Dot11ExtSetEtherTypeHandling después de completar correctamente la operación de asociación previa a través de una llamada a . Dot11ExtPreAssociateCompletion.

El sistema operativo tiene como valor predeterminado una lista vacía de exenciones de privacidad y registros etherType antes de la llamada de la función Dot11ExtIhvInitAdapter IHV Handler.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	wlanihv.h (incluye Wlanihv.h)