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 を含む)

こちらもご覧ください

ネイティブ 802.11 IHV ハンドラー関数

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer