PrlVmCfg_GetDefaultMemSize Function

The PrlVmCfg_GetDefaultMemSize function returns the default RAM size for to the specified OS type and version.

Syntax

PRL_RESULT PrlVmCfg_GetDefaultMemSize(
    PRL_UINT32 guestOsVersion, 
    PRL_UINT32 hostRam, 
    PRL_UINT32_PTR pnMemSize
);

File

PrlApiVm.h

Parameters

guestOsVersion

Operating system version. See PrlOses.h for type definitions.

hostRam

Optional. The amount of memory (RAM) available on the host system. For some operating system, this parameter may be used to calculate the default the RAM size more precisely.

pnMemSize

[out] A pointer to a variable that receives the result.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

When creating a virtual machine using a default configuration, the default memory size is defined for every supported operating system type and version. The default sizes can be retrieved using this function. The OS types are defined in the PrlOses.h file as macros. Look for the macros that are prefixed with PVS_GUEST_TYPE_ (e.g. PVS_GUEST_TYPE_MACOS). The OS versions can be found in the same file. The names of the macros are prefixed with PVS_GUEST_VER_ (e.g. PVS_GUEST_VER_MACOS_LEOPARD).

Links

PHT_VM_CONFIGURATION