Compartir a través de

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

  • Artículo
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 dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
El ARCHIVO DLL de extensiones IHV llama a la función Dot11ExtSendPacket para transmitir un paquete a través del adaptador inalámbrico LAN (WLAN).

Sintaxis

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

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] uPacketLen

Longitud, en bytes, del búfer asignado por el autor de la llamada al que hace referencia el parámetro pvPacket .

[in] pvPacket

Puntero a un búfer asignado por el autor de la llamada que contiene los datos que se van a transmitir, como se describe en la sección Comentarios.

[in, optional] hSendCompletion

Valor de identificador que identifica de forma única el paquete de envío.

Cuando el adaptador WLAN completa la operación de envío, el sistema operativo notifica al archivo DLL de extensiones de IHV a través de una llamada al Dot11ExtIhvSendPacketCompletion Función de controlador de IHV. Al realizar esta llamada, el sistema operativo pasa el valor de identificador del paquete a través del parámetro hSendCompletion .

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

El archivo DLL de extensiones de IHV debe seguir estas instrucciones al llamar a la función Dot11ExtSendPacket .

  • El paquete enviado a través de una llamada de la función Dot11ExtSendPacket se completará de forma asincrónica. El archivo DLL de extensiones de IHV no debe liberar la memoria a la que hace referencia el parámetro pvPacket hasta que Dot11ExtIhvSendPacketCompletion Se llama a la función Handler de IHV con el mismo valor de identificador que el parámetro hSendCompletion .
  • El archivo DLL de extensiones de IHV debe establecer el parámetro hSendCompletion en un valor que identifique de forma única los datos de paquete a los que hace referencia el parámetro pvPacket .
Para obtener más información sobre las funciones del controlador de IHV, vea Funciones de controlador IHV nativas 802.11.

El búfer al que apunta pvPacket debe contener los siguientes datos de paquete, especificados en el orden de bytes de red:

Estos datos de paquete se pasan al controlador de minipuerto.

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 (incluya Wlanihv.h)

Consulte también

Funciones de controlador IHV nativas 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

Administración de encabezados MAC 802.11