RtlFreeHeap 函式 (ntifs.h)
RtlFreeHeap 例程會釋放由 RtlAllocateHeap 從堆積配置的記憶體區塊。
語法
NTSYSAPI LOGICAL RtlFreeHeap(
[in] PVOID HeapHandle,
[in, optional] ULONG Flags,
_Frees_ptr_opt_ PVOID BaseAddress
);
參數
[in] HeapHandle
要釋放其記憶體區塊之堆積的句柄。 此參數是由 RtlCreateHeap所傳回的句柄。
[in, optional] Flags
一組旗標,可控制釋放記憶體區塊的各個層面。 指定下列值會覆寫由 RtlCreateHeap建立堆積時,Flags 參數中指定的對應值。
旗 | 意義 |
---|---|
HEAP_NO_SERIALIZE | RtlFreeHeap 存取堆積時,將不會使用相互排除。 |
BaseAddress
要釋放之內存區塊的指標。 此指標是由 RtlAllocateHeap所傳回。
傳回值
RtlFreeHeap 如果成功釋放區塊,則會傳 回 true true;否則 FALSE。
Note 從 Windows 8 開始,傳回值會輸入為 LOGICAL,其大小與 BOOLEAN 不同。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可從 Windows XP 開始使用。 |
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |