次の方法で共有


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

重要Native 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コードを返します。 次のERROR_xxxx コードは、通常、Dot11ExtAllocateBuffer 関数によって返されます。

リターン コード 形容
ERROR_SUCCESS
呼び出しはエラーなしで成功しました。
ERROR_OUTOFMEMORY
リソースがないため、オペレーティング システムはメモリを割り当てませんでした。

備考

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

  • IHV 拡張 DLL は、IHV ハンドラー関数から可変長バッファーを返すときに、この関数を呼び出す必要があります。 この状況では、オペレーティング システムは、IHV ハンドラー関数の戻り後にバッファーを解放します。

    IHV ハンドラー関数の詳細については、「ネイティブ 802.11 IHV ハンドラー関数を参照してください。

  • IHV 拡張機能 DLL は、DLL 自体によって参照されるメモリを割り当てるために、この関数を呼び出す場合があります。

    このような場合、DLL は Dot11ExtFreeBuffer 呼び出すことによってメモリ バッファーを解放する必要があります。

必要条件

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

関連項目

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

dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer