DOT11EXT_ALLOCATE_BUFFER回呼函式（wlanihv.h）

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。請改用 WLAN 裝置驅動器介面（WDI）。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

IHV 延伸模組 DLL 會呼叫 Dot11ExtAllocateBuffer 函式來配置可變長度緩衝區的記憶體。

語法

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

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

[in] dwByteCount

要配置的緩衝區大小，以位元組為單位。

[out] ppvBuffer

呼叫端提供的變數指標，可儲存已配置緩衝區的位址。如果傳回值是ERROR_SUCCESS，ppvBuffer 參數具有有效的非 Null 值。

呼叫會傳回 Winerror.h 中定義的ERROR_xxxx程序代碼。下列ERROR_xxxx程序代碼通常是由 Dot11ExtAllocateBuffer 函式傳回。

傳回碼	描述
ERROR_SUCCESS	呼叫成功，而不會發生錯誤。
ERROR_OUTOFMEMORY	作系統因為資源不足而無法配置記憶體。

呼叫 Dot11ExtAllocateBuffer 函式時，IHV 延伸模組 DLL 必須遵循這些指導方針。

從 IHV Handler 函式傳回任何可變長度緩衝區時，IHV 延伸模組 DLL 必須呼叫此函式。在此情況下，作系統負責在IHV Handler函式傳回之後釋放緩衝區。
如需 IHV 處理程式函式的詳細資訊，請參閱 Native 802.11 IHV 處理程式函式。
IHV 延伸模組 DLL 可能會呼叫此函式，以配置 DLL 本身所參考的記憶體。
在此情況下，DLL 必須呼叫 Dot11ExtFreeBuffer來釋放記憶體緩衝區。

要求	價值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺	桌面
標頭	wlanihv.h （包括 Wlanihv.h）