CWin32Heap – třída

Tato třída implementuje IAtlMemMgr pomocí funkcí přidělení haldy Win32.

Důležité

Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Syntaxe

class CWin32Heap : public IAtlMemMgr

Členové

Veřejné konstruktory

Jméno	popis
CWin32Heap::CWin32Heap	Konstruktor
CWin32Heap::~CWin32Heap	Destruktor.

Veřejné metody

Jméno	popis
CWin32Heap::Přidělení	Přidělí blok paměti z objektu haldy.
CWin32Heap::Attach	Připojí objekt haldy k existující haldě.
CWin32Heap::D etach	Odpojte objekt haldy od existující haldy.
CWin32Heap::Free	Uvolní paměť dříve přidělenou z haldy.
CWin32Heap::GetSize	Vrátí velikost bloku paměti přiděleného z objektu haldy.
CWin32Heap::Reallocate	Relokuje blok paměti z objektu haldy.

Veřejné datové členy

Jméno	popis
CWin32Heap::m_bOwnHeap	Příznak sloužící k určení aktuálního vlastnictví popisovače haldy.
CWin32Heap::m_hHeap	Popisovač objektu haldy

Poznámky

CWin32Heap implementuje metody přidělování paměti pomocí funkcí přidělení haldy Win32, včetně HeapAlloc a HeapFree. Na rozdíl od ostatních tříd haldy vyžaduje, CWin32Heap aby byl před přidělením paměti poskytnut platný popisovač haldy: ostatní třídy jsou výchozí pro použití haldy procesu. Popisovač lze zadat konstruktoru nebo CWin32Heap ::Attach metoda. Další podrobnosti najdete v metodě CWin32Heap::CWin32Heap .

Příklad

Podívejte se na příklad pro IAtlMemMgr.

Hierarchie dědičnosti

IAtlMemMgr

CWin32Heap

Požadavky

Hlavička: atlmem.h

CWin32Heap::Přidělení

Přidělí blok paměti z objektu haldy.

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

Parametry

nBajty
Požadovaný počet bajtů v novém bloku paměti.

Vrácená hodnota

Vrátí ukazatel na nově přidělený blok paměti.

Poznámky

Volání CWin32Heap::Free nebo CWin32Heap::Reallocate uvolnit paměť přidělenou touto metodou.

Implementováno pomocí HeapAlloc.

CWin32Heap::Attach

Připojí objekt haldy k existující haldě.

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

Parametry

hHeap
Existující úchyt haldy.

bTakeOwnership
Příznak označující, jestli CWin32Heap má objekt převzít vlastnictví prostředků haldy.

Poznámky

Pokud bTakeOwnership je TRUE, CWin32Heap objekt je zodpovědný za odstranění popisovače haldy.

CWin32Heap::CWin32Heap

Konstruktor

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

Parametry

hHeap
Existující objekt haldy

dwFlags
Příznaky použité při vytváření haldy

nInitialSize
Počáteční velikost haldy

nMaxSize
Maximální velikost haldy

Poznámky

Před přidělením paměti je nutné poskytnout CWin32Heap objekt platným popisovačem haldy. Nejsnáze toho dosáhnete pomocí haldy procesu:

CWin32Heap MyHeap(GetProcessHeap());   

Je také možné zadat do konstruktoru existující popisovač haldy; v tomto případě nový objekt nepřevezme vlastnictví haldy. Původní popisovač haldy bude při odstranění objektu CWin32Heap stále platný.

Existující haldu lze také připojit k novému objektu pomocí CWin32Heap::Attach.

Pokud se halda vyžaduje tam, kde se všechny operace provádějí z jednoho vlákna, je nejlepší vytvořit tento objekt takto:

CWin32Heap MyHeap(HEAP_NO_SERIALIZE, SomeInitialSize);   

Parametr HEAP_NO_SERIALIZE určuje, že vzájemné vyloučení se nepoužije, když funkce haldy přidělují a uvolní paměť s odpovídajícím zvýšením výkonu.

Třetí parametr má výchozí hodnotu 0, což umožňuje, aby halda narůstala podle potřeby. Vysvětlení velikostí paměti a příznaků najdete v tématu HeapCreate .

CWin32Heap::~CWin32Heap

Destruktor.

~CWin32Heap() throw();

Poznámky

Zničí úchyt haldy, pokud CWin32Heap má objekt vlastnictví haldy.

CWin32Heap::D etach

Odpojte objekt haldy od existující haldy.

HANDLE Detach() throw();

Vrácená hodnota

Vrátí popisovač haldy, ke které byl objekt dříve připojen.

CWin32Heap::Free

Uvolní paměť dříve přidělenou z haldy CWin32Heap ::Allocate nebo CWin32Heap::Reallocate.

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

Parametry

P
Ukazatel na blok paměti na uvolnění. NULL je platná hodnota a nic nedělá.

CWin32Heap::GetSize

Vrátí velikost bloku paměti přiděleného z objektu haldy.

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

Parametry

P
Ukazatel na blok paměti, jehož velikost metoda získá. Jedná se o ukazatel vrácený CWin32Heap::Allocate nebo CWin32Heap::Reallocate.

Vrácená hodnota

Vrátí velikost přiděleného bloku paměti v bajtech.

CWin32Heap::m_bOwnHeap

Příznak použitý k určení aktuálního vlastnictví popisovače haldy uložené v m_hHeap.

bool m_bOwnHeap;

CWin32Heap::m_hHeap

Popisovač objektu haldy

HANDLE m_hHeap;

Poznámky

Proměnná použitá k uložení popisovače do objektu haldy.

CWin32Heap::Reallocate

Relokuje blok paměti z objektu haldy.

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

Parametry

P
Ukazatel na blok paměti k opětovnému přidělení.

nBajty
Nová velikost v bajtech přiděleného bloku. Blok může být větší nebo menší.

Vrácená hodnota

Vrátí ukazatel na nově přidělený blok paměti.

Poznámky

Pokud p je NULL, předpokládá se, že blok paměti ještě nebyl přidělen a CWin32Heap::Allocate je volána s argumentem nBytes.

Viz také

Přehled třídy
IAtlMemMgr – třída
CLocalHeap – třída
CGlobalHeap – třída
CCRTHeap – třída
CComHeap – třída