Dot11ExtAllocateBuffer (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this function to allocate memory for variable-length buffers.

Syntax

DWORD WINAPI  Dot11ExtAllocateBuffer(
    DWORD  dwByteCount,
    LPVOID* ppvBuffer
);

Parameters

• dwByteCount
  [in] Size, in bytes, of the buffer to allocate

• ppvBuffer
  [out] A pointer to a caller-supplied variable that stores the address of the allocated buffer. The ppvBuffer parameter has a valid non-null value if the return value is ERROR_SUCCESS.

Return Value

The call returns an ERROR_xxxx code defined in Winerror.h. The following ERROR_xxxx codes are ordinarily returned by the Dot11ExtAllocateBuffer function:

Return	Meaning
ERROR_SUCCESS	The call succeeded without an error
ERROR_OUTOFMEMORY	The operating system was unable to allocate the memory because of a lack of resources

Remarks

The IHV Extensions DLL must follow these guidelines when it calls the Dot11ExtAllocateBuffer function.

• The IHV Extensions DLL must call this function when it returns any variable-length buffer from an IHV Handler function. In this situation, the operating system is responsible for freeing the buffer after the return of the IHV Handler function.
  For more information about the IHV Handler functions, see Native 802.11 IHV Handler Functions.
• The IHV Extensions DLL might call this function to allocate memory referenced by the DLL itself.
  In this situation, the DLL must free the memory buffer by calling Dot11ExtFreeBuffer.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Native 802.11 IHV Handler Functions
Dot11ExtFreeBuffer
Dot11ExtIhvCreateDiscoveryProfiles
Native 802.11 IHV Extensions DLL