DOT11EXT_ALLOCATE_BUFFER コールバック関数 (wlanihv.h)
重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。
構文
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 関数によって返されます。
リターン コード | 形容 |
---|---|
|
呼び出しはエラーなしで成功しました。 |
|
リソースがないため、オペレーティング システムはメモリを割り当てませんでした。 |
備考
IHV 拡張機能 DLL は、Dot11ExtAllocateBuffer 関数を呼び出すときに、これらのガイドラインに従う必要があります。
-
IHV 拡張 DLL は、IHV ハンドラー関数から可変長バッファーを返すときに、この関数を呼び出す必要があります。 この状況では、オペレーティング システムは、IHV ハンドラー関数の戻り後にバッファーを解放します。
IHV ハンドラー関数の詳細については、「ネイティブ 802.11 IHV ハンドラー関数を参照してください。
-
IHV 拡張機能 DLL は、DLL 自体によって参照されるメモリを割り当てるために、この関数を呼び出す場合があります。
このような場合、DLL は Dot11ExtFreeBuffer 呼び出すことによってメモリ バッファーを解放する必要があります。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | wlanihv.h (Wlanihv.h を含む) |
関連項目
dot11ExtIhvCreateDiscoveryProfiles のDot11ExtFreeBuffer の