CWin32Heap 클래스

이 클래스는 Win32 힙 할당 함수를 사용하여 IAtlMemMgr 을 구현합니다.

Important

이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.

구문

class CWin32Heap : public IAtlMemMgr

멤버

공용 생성자

속성	설명
CWin32Heap::CWin32Heap	생성자입니다.
CWin32Heap::~CWin32Heap	소멸자입니다.

공용 메서드

이름	설명
CWin32Heap::Allocate	힙 개체에서 메모리 블록을 할당합니다.
CWin32Heap::Attach	기존 힙에 힙 개체를 연결합니다.
CWin32Heap::D etach	기존 힙에서 힙 개체를 분리합니다.
CWin32Heap::Free	힙에서 이전에 할당된 메모리를 해제합니다.
CWin32Heap::GetSize	힙 개체에서 할당된 메모리 블록의 크기를 반환합니다.
CWin32Heap::재할당	힙 개체에서 메모리 블록을 다시 할당합니다.

공용 데이터 멤버

이름	설명
CWin32Heap::m_bOwnHeap	힙 핸들의 현재 소유권을 확인하는 데 사용되는 플래그입니다.
CWin32Heap::m_hHeap	힙 개체에 대한 핸들입니다.

설명

CWin32Heap는 HeapAlloc 및 HeapFree를 비롯한 Win32 힙 할당 함수를 사용하여 메모리 할당 메서드를 구현합니다. 다른 힙 클래스와 CWin32Heap 달리 메모리가 할당되기 전에 유효한 힙 핸들을 제공해야 합니다. 다른 클래스는 기본적으로 프로세스 힙을 사용합니다. 핸들은 생성자 또는 CWin32Heap::Attach 메서드에 제공할 수 있습니다. 자세한 내용은 CWin32Heap::CWin32Heap 메서드를 참조하세요.

예시

IAtlMemMgr에 대한 예제를 참조하세요.

상속 계층 구조

IAtlMemMgr

CWin32Heap

요구 사항

헤더: atlmem.h

CWin32Heap::Allocate

힙 개체에서 메모리 블록을 할당합니다.

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

매개 변수

nBytes
새 메모리 블록의 요청된 바이트 수입니다.

Return Value

새로 할당된 메모리 블록에 대한 포인터를 반환합니다.

설명

CWin32Heap::Free 또는 CWin32Heap::Reallocate를 호출하여 이 메서드에서 할당한 메모리를 해제합니다.

HeapAlloc를 사용하여 구현됩니다.

CWin32Heap::Attach

기존 힙에 힙 개체를 연결합니다.

void Attach(HANDLE hHeap, bool bTakeOwnership) throw();

매개 변수

hHeap
기존 힙 핸들입니다.

bTakeOwnership
개체가 힙의 리소스에 CWin32Heap 대한 소유권을 가져오는지 여부를 나타내는 플래그입니다.

설명

bTakeOwnership이 TRUE CWin32Heap 이면 개체가 힙 핸들을 삭제해야 합니다.

CWin32Heap::CWin32Heap

생성자입니다.

CWin32Heap() throw();
CWin32Heap( HANDLE  hHeap) throw();
CWin32Heap(
    DWORD  dwFlags,
    size_t nInitialSize,
    size_t nMaxSize = 0);

매개 변수

hHeap
기존 힙 개체입니다.

dwFlags
힙을 만드는 데 사용되는 플래그입니다.

nInitialSize
힙의 초기 크기입니다.

nMaxSize
힙의 최대 크기입니다.

설명

메모리를 할당하기 전에 CWin32Heap 개체에 유효한 힙 핸들을 제공해야 합니다. 이는 프로세스 힙을 사용할 수 있는 가장 간단한 방법입니다.

CWin32Heap MyHeap(GetProcessHeap());   

또한 새 개체가 힙의 소유권을 계승하지 않는 경우 생성자에게 기존 힙 핸들을 제공할 수 있습니다. CWin32Heap 개체를 삭제해도 원래 힙 핸들은 계속해서 유효합니다.

CWin32Heap::Attach를 사용하여 기존 힙을 새 개체에 연결할 수도 있습니다.

작업이 하나의 스레드에서 모두 수행된 위치에 힙이 필요한 경우 다음과 같이 개체를 만드는 것이 가장 좋습니다.

CWin32Heap MyHeap(HEAP_NO_SERIALIZE, SomeInitialSize);   

매개 변수 HEAP_NO_SERIALIZE 힙 함수가 메모리를 할당하고 사용 가능한 경우 성능이 향상될 때 상호 제외가 사용되지 않도록 지정합니다.

세 번째 매개 변수의 기본값이 0으로 지정되어, 필요에 따라 힙을 증가시킬 수 있습니다. 메모리 크기 및 플래그에 대한 설명은 HeapCreate를 참조하세요.

CWin32Heap::~CWin32Heap

소멸자입니다.

~CWin32Heap() throw();

설명

개체에 힙의 소유권이 있는 CWin32Heap 경우 힙 핸들을 삭제합니다.

CWin32Heap::D etach

기존 힙에서 힙 개체를 분리합니다.

HANDLE Detach() throw();

Return Value

개체가 이전에 연결된 힙에 대한 핸들을 반환합니다.

CWin32Heap::Free

이전에 CWin32Heap::Allocate 또는 CWin32Heap::Reallocate에 의해 힙에서 할당된 메모리를 해제합니다.

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

매개 변수

p
해제할 메모리 블록에 대한 포인터입니다. NULL은 유효한 값이며 아무 작업도 수행하지 않습니다.

CWin32Heap::GetSize

힙 개체에서 할당된 메모리 블록의 크기를 반환합니다.

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

매개 변수

p
메서드의 크기를 가져올 메모리 블록에 대한 포인터입니다. CWin32Heap::Allocate 또는 CWin32Heap::Reallocate에서 반환되는 포인터입니다.

Return Value

할당된 메모리 블록의 크기(바이트)를 반환합니다.

CWin32Heap::m_bOwnHeap

m_hHeap 저장된 힙 핸들의 현재 소유권을 확인하는 데 사용되는 플래그입니다.

bool m_bOwnHeap;

CWin32Heap::m_hHeap

힙 개체에 대한 핸들입니다.

HANDLE m_hHeap;

설명

힙 개체에 대한 핸들을 저장하는 데 사용되는 변수입니다.

CWin32Heap::재할당

힙 개체에서 메모리 블록을 다시 할당합니다.

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

매개 변수

p
다시 할당할 메모리 블록에 대한 포인터입니다.

nBytes
할당된 블록의 새 크기(바이트)입니다. 블록은 더 크거나 작을 수 있습니다.

Return Value

새로 할당된 메모리 블록에 대한 포인터를 반환합니다.

설명

p가 NULL인 경우 메모리 블록이 아직 할당되지 않았으며 CWin32Heap::Allocate가 nBytes 인수와 함께 호출된 것으로 가정합니다.

참고 항목

클래스 개요
IAtlMemMgr 클래스
CLocalHeap 클래스
CGlobalHeap 클래스
CCRTHeap 클래스
CComHeap 클래스