On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

VirtualFree

The VirtualFree function releases or decommits (or both) a region of pages within the virtual address space of the calling process.

BOOL VirtualFree(

LPVOID lpAddress, // address of region of committed pages
DWORD dwSize, // size of region
DWORD dwFreeType // type of free operation
);

Parameters

lpAddress

Points to the base address of the region of pages to be freed. If the dwFreeType parameter includes the MEM_RELEASE flag, this parameter must be the base address returned by the VirtualAlloc function when the region of pages was reserved.

dwSize

Specifies the size, in bytes, of the region to be freed. If the dwFreeType parameter includes the MEM_RELEASE flag, this parameter must be zero. Otherwise, the region of affected pages includes all pages containing one or more bytes in the range from the lpAddress parameter to (lpAddress+dwSize). This means that a 2-byte range straddling a page boundary causes both pages to be freed.

dwFreeType

Specifies the type of free operation. One, but not both, of the following flags can be specified:

Flag Meaning
MEM_DECOMMIT Decommits the specified region of committed pages.
An attempt to decommit an uncommitted page will not cause the function to fail. This means that a range of committed or uncommitted pages can be decommitted without having to worry about a failure.
MEM_RELEASE Releases the specified region of reserved pages. If this flag is specified, the dwSize parameter must be zero, or the function fails.

Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

VirtualFree can perform one of the following operations:

· Decommit a region of committed or uncommitted pages.
· Release a region of reserved pages.
· Decommit and release a region of committed or uncommitted pages.

To release a region of pages, the entire range of pages must be in the same state (all reserved or all committed) and the entire region originally reserved by the VirtualAlloc function must be released at the same time. If only part of the pages in the original reserved region are committed, you must first call VirtualFree to decommit the committed pages and then call VirtualFree again to release the entire block.
Pages that have been released are free pages available for subsequent allocation operations. Attempting to read from or write to a free page results in an access violation exception.

VirtualFree can decommit an uncommitted page; this means that a range of committed or uncommitted pages can be decommitted without having to worry about a failure. Decommitting a page releases its physical storage, either in memory or in the paging file on disk. If a page is decommitted but not released, its state changes to reserved, and it can be committed again by a subsequent call to VirtualAlloc. Attempting to read from or write to a reserved page results in an access violation exception.

The current state of the entire range of pages must be compatible with the type of free operation specified by the dwFreeType parameter. Otherwise, the function fails and no pages are released or decommitted.

See Also

GlobalAlloc, GlobalFree, VirtualAlloc

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

VirtualFree

Функция VirtualFree выпускает или decommits (или оба) регион страниц в пределах виртуального пространства адреса вызова процесса.

BOOL VirtualFree(

LPVOID lpAddress, // АДРЕС региона совершенных страниц DWORD dwSize, // размера типа региона DWORD dwFreeType // свободного действия
);

Параметры

lpAddress

Точки на базовый адрес региона страниц, которые нужно освобождаться. Если параметр dwFreeType включает флаг MEM_RELEASE, этот параметр должен быть базовым адресом возвращанным функцией VirtualAlloc когда регион страниц был зарезервирован.

dwSize

Определяет размер, в байтах, региона, который нужно освобождаться. Если параметр dwFreeType включает флаг MEM_RELEASE, этот параметр должен - нулевым. В противном случае, регион неестественных страниц включает все страницы, содержащие один или более байтов в дипазоне из параметра lpAddress, чтобы (lpAddress+dwSize). Это означает, что 2- байтовый дипазон, перекрывающий страничную границу вызывает обе страницы, которые нужно освобождаться.

dwFreeType

Определяет тип свободного действия. Один, но не оба, следующего флагов может быть определено:

Значение Флага
MEM_DECOMMIT Decommits определенный регион совершенных страниц.
Попытка, чтобы decommit неприсоединившаяся страница не заставит функцию, чтобы терпеть неудачу. Это означает, что дипазон совершенных или неприсоединившихся страниц может decommitted без необходимости беспокоиться о неудаче.
MEM_RELEASE Выпускает определенный регион резервных страниц. Если этот флаг определен, параметр dwSize должен быть нулем, или функция терпит неудачу.

Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

VirtualFree МОЖЕТ выполнить одну из следующих операций:

Decommit Область совершенных или неприсоединившихся страниц.
Версия область резервных страниц.
Decommit И выпускать область совершенных или неприсоединившихся страниц.

Чтобы выпускать область страниц, целый дипазон страниц должен быть в том же состоянии (все зарезервированные или все совершенный) и целая область первоначально зарезервированная функцией VirtualAlloc должна выпускаться в то же самое время. Если только часть страниц в подлиннике зарезервировавшем область совершены, Вы должны сначала вызов VirtualFree, чтобы decommit совершенные страницы затем называть VirtualFree снова, чтобы выпускать целого блока.
Страницы, которые выпущены, - свободные страницы доступные для последующих операций распределения. Пытаясь, чтобы читаться из или записываться в свободные страничные результаты в исключении нарушения доступа.

VirtualFree МОЖЕТ decommit неприсоединившаяся страница; это означает, что дипазон совершенных или неприсоединившихся страниц может decommitted без необходимости беспокоиться о неудаче. Decommitting Страница выпускает свою физическую память, или в памяти или в файле подкачки на диске. Если страница decommitted но не выпущенное, состояние изменяется на зарезервированное, и может быть совершено снова последующим вызовом на VirtualAlloc. Пытаясь, чтобы читаться из или записываться в резервные страничные результаты в исключении нарушения доступа.

Текущее состояние целого дипазона страниц должно быть совместимым с типом свободной операции определенной параметром dwFreeType. В противном случае, функция терпит неудачу и никакие страницы не выпущены или decommitted.

Смотри Также

GlobalAlloc, GlobalFree, VirtualAlloc

Используются технологии uCoz