DOT11EXT_ALLOCATE_BUFFER wlanihv.h) (回呼函式

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 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程序代碼。 Dot11ExtAllocateBuffer 函式通常會傳回下列ERROR_xxxx代碼。

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

呼叫 Dot11ExtAllocateBuffer 函式時，IHV 擴充功能 DLL 必須遵循這些指導方針。

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

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	wlanihv.h (包含 Wlanihv.h)