Compartir a través de

DOT11EXT_ALLOCATE_BUFFER 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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.
 
El archivo DLL de extensiones IHV llama a la función Dot11ExtAllocateBuffer para asignar memoria para los búferes de longitud variable.

Sintaxis

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

DWORD Dot11extAllocateBuffer(
  [in]  DWORD dwByteCount,
  [out] LPVOID *ppvBuffer
)
{...}

Parámetros

[in] dwByteCount

Tamaño, en bytes, del búfer que se va a asignar.

[out] ppvBuffer

Puntero a una variable proporcionada por el autor de la llamada que almacena la dirección del búfer asignado. El parámetro ppvBuffer tiene un valor no NULL válido si el valor devuelto es ERROR_SUCCESS.

Valor devuelto

La llamada devuelve un código ERROR_xxxx definido en Winerror.h. Normalmente, la función Dot11ExtAllocateBuffer devuelve los siguientes códigos de ERROR_xxxx.

Código devuelto Descripción
ERROR_SUCCESS
 La llamada se realizó correctamente sin un error.
ERROR_OUTOFMEMORY
 El sistema operativo no pudo asignar la memoria debido a la falta de recursos.

Comentarios

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

  • El archivo DLL de extensiones IHV debe llamar a esta función al devolver cualquier búfer de longitud variable desde una función de controlador de IHV. En esta situación, el sistema operativo es responsable de liberar el búfer después de la devolución de la función IHV Handler.

    Para obtener más información sobre las funciones del controlador IHV, consulte Funciones del controlador IHV nativas 802.11.

  • El archivo DLL de extensiones IHV podría llamar a esta función para asignar memoria a la que hace referencia el propio archivo DLL.

    En esta situación, el archivo DLL debe liberar el búfer de memoria llamando a Dot11ExtFreeBuffer.

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)

Consulte también

Funciones del controlador IHV nativas 802.11

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer