Show/Hide TOC

Kernel32OfferVirtualMemory(IntPtr, IntPtr, OfferVirtualMemoryPriority) Method

Indicates that the data contained in a range of memory pages is no longer needed by the application and can be discarded by the system if necessary.

The specified pages will be marked as inaccessible, removed from the process working set, and will not be written to the paging file.

To later reclaim offered pages, call ReclaimVirtualMemory(IntPtr, IntPtr) function.

Definition

Namespace: DevCase.Win32.NativeMethods
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.

C#Request Example

[DllImportAttribute("Kernel32.dll", ExactSpelling = true, SetLastError = true)]
public static Win32ErrorCode OfferVirtualMemory(
	IntPtr address,
	IntPtr size,
	OfferVirtualMemoryPriority priority
)

VBRequest Example

<DllImportAttribute("Kernel32.dll", ExactSpelling := true, SetLastError := true>]
Public Shared Function OfferVirtualMemory ( 
	address As IntPtr,
	size As IntPtr,
	priority As OfferVirtualMemoryPriority
) As Win32ErrorCode

Dim address As IntPtr
Dim size As IntPtr
Dim priority As OfferVirtualMemoryPriority

Dim returnValue As Win32ErrorCode

returnValue = Kernel32.OfferVirtualMemory(address, 
	size, priority)

C++Request Example

public:
[DllImportAttribute(L"Kernel32.dll", ExactSpelling = true, SetLastError = true)]
static Win32ErrorCode OfferVirtualMemory(
	IntPtr address, 
	IntPtr size, 
	OfferVirtualMemoryPriority priority
)

F#Request Example

[<DllImportAttribute("Kernel32.dll", ExactSpelling = true, SetLastError = true)>]
static member OfferVirtualMemory : 
        address : IntPtr * 
        size : IntPtr * 
        priority : OfferVirtualMemoryPriority -> Win32ErrorCode

ASP.NETRequest Example

No code example is currently available or this language may not be supported.

Parameters

address IntPtr: Page-aligned starting address of the memory to offer.
size IntPtr: Size, in bytes, of the memory region to offer. size must be an integer multiple of the system page size.
priority OfferVirtualMemoryPriority: Indicates how important the offered memory is to the application.
A higher priority increases the probability that the offered memory can be reclaimed intact when calling ReclaimVirtualMemory(IntPtr, IntPtr) function. The system typically discards lower priority memory before discarding higher priority memory.

Return Value

Win32ErrorCode
Returns ERROR_SUCCESS if successful. Returns a System Error Code (Win32ErrorCode) otherwise.

Remarks

https://docs.microsoft.com/en-us/windows/desktop/api/memoryapi/nf-memoryapi-offervirtualmemory

Kernel32OfferVirtualMemory(IntPtr, IntPtr, OfferVirtualMemoryPriority) Method

Definition

Parameters

Return Value

Remarks

See Also

Reference