CGlobalHeap クラス

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

重要

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

構文

class CGlobalHeap : public IAtlMemMgr

メンバー

パブリック メソッド

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

解説

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

Note

グローバル ヒープ関数は、他のメモリ管理機能よりも低速で、多くの機能を提供しません。 そのため、新しいアプリケーションではヒープ関数を使用する必要があります。 CWin32Heap クラスで使用可能です。 グローバル関数は、DDE とクリップボード関数によって引き続き使用されます。

例

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

継承階層

IAtlMemMgr

CGlobalHeap

必要条件

ヘッダー: atlmem.h

CGlobalHeap::Allocate

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

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

パラメーター

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

戻り値

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

解説

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

フラグ パラメーターが GMEM_FIXED の GlobalAlloc を使用して実装されます。

CGlobalHeap::Free

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

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

パラメーター

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

解説

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

CGlobalHeap::GetSize

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

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

パラメーター

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

戻り値

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

解説

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

CGlobalHeap::Reallocate

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

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

パラメーター

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

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

戻り値

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

解説

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

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

関連項目

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