DOT11EXT_ALLOCATE_BUFFER コールバック関数 (wlanihv.h)

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

IHV Extensions 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	リソースがないため、オペレーティングシステムでメモリを割り当てることができませんでした。

IHV 拡張機能 DLL は 、Dot11ExtAllocateBuffer 関数を呼び出すときに、次のガイドラインに従う必要があります。

IHV ハンドラー関数から可変長バッファーを返す場合、IHV Extensions DLL は、この関数を呼び出す必要があります。この状況では、オペレーティングシステムは、IHV ハンドラー関数の戻り後にバッファーを解放する必要があります。
IHV ハンドラー関数の詳細については、「ネイティブ 802.11 IHV ハンドラー関数」を参照してください。
IHV 拡張機能 DLL は、DLL 自体によって参照されるメモリを割り当てるために、この関数を呼び出す場合があります。
この状況では、DLL は Dot11ExtFreeBuffer を呼び出してメモリバッファーを解放する必要があります。

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	wlanihv.h (Wlanihv.h を含む)