IHostMemoryManager::VirtualAlloc Method

  • Article

Serves as a logical wrapper for the corresponding Win32 function. The Win32 implementation of VirtualAlloc reserves or commits a region of pages in the virtual address space of the calling process.

HRESULT VirtualAlloc (
    [in]  void*   pAddress,
    [in]  SIZE_T  dwSize,
    [in]  DWORD   flAllocationType,
    [in]  DWORD   flProtect,
    [in]  EMemoryCriticalLevel dwCriticalLevel,
    [out] void**  ppMem
);

Parameters

  • pAddress
    [in] A pointer to the starting address of the region to allocate.

  • dwSize
    [in] The size, in bytes, of the region.

  • flAllocationType
    [in] The type of memory allocation.

  • flProtect
    [in] Memory protection for the region of pages to be allocated.

  • dwCriticalLevel
    [in] An EMemoryCriticalLevel value that indicates the impact of an allocation failure.

  • ppMem
    [out] Pointer to the starting address of the allocated memory, or null if the request could not be satisfied.

Return Value

HRESULT

Description

S_OK

VirtualAlloc returned successfully.

HOST_E_CLRNOTAVAILABLE

The common language runtime (CLR) has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.

HOST_E_TIMEOUT

The call timed out.

HOST_E_NOT_OWNER

The caller does not own the lock.

HOST_E_ABANDONED

An event was canceled while a blocked thread or fiber was waiting on it.

E_FAIL

An unknown catastrophic failure occurred. When a method returns E_FAIL, the CLR is no longer usable within the process. Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.

E_OUTOFMEMORY

Not enough memory was available to complete the allocation request

Remarks

You reserve a region in the address space of your process by calling VirtualAlloc. The pAddress parameter contains the beginning address of the memory block you want. This parameter is typically set to null. The operating system keeps a record of free address ranges available to your process. A pAddress value of null instructs the system to reserve the region wherever it sees fit. Alternatively, you can provide a specific starting address for the memory block. In both cases, the output parameter ppMem is returned as a pointer to the allocated memory. The function itself returns an HRESULT value.

The Win32 VirtualAlloc function does not have a ppMem parameter, and returns the pointer to the allocated memory instead. For more information, see the Windows Platform documentation.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

IHostMemoryManager Interface