DOT11EXT_ALLOCATE_BUFFER función de devolución de llamada (wlanihv.h)
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. Los siguientes códigos de ERROR_xxxx suelen devolverse mediante la función Dot11ExtAllocateBuffer.
| Código devuelto | Descripción |
|---|---|
|
La llamada se realizó correctamente sin un error. |
|
El sistema operativo no pudo asignar la memoria debido a la falta de recursos. |
Observaciones
El archivo DLL de extensiones de IHV debe seguir estas instrucciones al llamar a la función Dot11ExtAllocateBuffer.
-
El archivo DLL de extensiones de IHV debe llamar a esta función al devolver cualquier búfer de longitud variable desde una función del 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 controlador de IHV.
Para obtener más información sobre las funciones del controlador de IHV, consulte funciones de controlador IHV nativas 802.11.
-
El archivo DLL de extensiones de 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wlanihv.h (incluya Wlanihv.h) |
Consulte también
funciones de controlador IHV nativas 802.11
Dot11ExtIhvCreateDiscoveryProfiles