次の方法で共有

CLocalHeap クラス

  • [アーティクル]

このクラスは、Win32 ローカル ヒープ関数を使用して IAtlMemMgr を実装します。

重要

このクラスとそのメンバーは、Windows ランタイムで実行するアプリケーションで使用することはできません。

構文

class CLocalHeap : public IAtlMemMgr

メンバー

パブリック メソッド

名前 説明
CLocalHeap::Allocate メモリ ブロックを割り当てるには、このメソッドを呼び出します。
CLocalHeap::Free このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリ ブロックを解放します。
CLocalHeap::GetSize このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリ ブロックのサイズを取得します。
CLocalHeap::Reallocate このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリの再割り当てを行います。

解説

CLocalHeap では、Win32 ローカル ヒープ関数を利用し、メモリ割り当て関数が実装されます。

Note

ローカル ヒープ関数は、他のメモリ管理機能よりも低速で、多くの機能を提供しません。 そのため、新しいアプリケーションではヒープ関数を使用する必要があります。 CWin32Heap クラスで使用可能です。

例

IAtlMemMgr の例を参照してください。

継承階層

IAtlMemMgr

CLocalHeap

要件

ヘッダー: atlmem.h

CLocalHeap::Allocate

メモリ ブロックを割り当てるには、このメソッドを呼び出します。

virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();

パラメーター

nBytes
新しいメモリ ブロック内の要求されたバイト数。

戻り値

新しく割り当てられたメモリ ブロックの先頭へのポインターを返します。

解説

このメソッドによって割り当てられたメモリを解放するには、CLocalHeap::Free または CLocalHeap::Reallocate を呼び出します。

LMEM_FIXED フラグ パラメーターが指定された LocalAlloc を使って実装されます。

CLocalHeap::Free

このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリ ブロックを解放します。

virtual void Free(void* p) throw();

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。 NULL は有効な値であり、何も行いません。

解説

LocalFree を使用して実装されます。

CLocalHeap::GetSize

このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリ ブロックのサイズを取得します。

virtual size_t GetSize(void* p) throw();

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。

戻り値

割り当てられたメモリのサイズ (バイト単位) が返されます。

解説

LocalSize を使用して実装されます。

CLocalHeap::Reallocate

このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリの再割り当てを行います。

virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。

nBytes
新しいメモリ ブロック内の要求されたバイト数。

戻り値

新しく割り当てられたメモリ ブロックの先頭へのポインターを返します。

解説

このメソッドによって割り当てられたメモリを解放するには、CLocalHeap::Free を呼び出します。

LocalReAlloc を使用して実装されます。

関連項目

クラスの概要
CComHeap クラス
CWin32Heap クラス
CGlobalHeap クラス
CCRTHeap クラス
IAtlMemMgr クラス