PrlVmCfg_IsDefaultDeviceNeeded Function

Determines whether the virtual machine requires a default device of the specified type if it's going to run an operating system of the specified type.

Syntax

PRL_RESULT PrlVmCfg_IsDefaultDeviceNeeded(
    PRL_UINT32 guestOsVersion, 
    PRL_DEVICE_TYPE deviceType, 
    PRL_BOOL_PTR pbNeeded
);

File

PrlApiVm.h

Parameters

guestOsVersion

Target OS version. The OS versions are defined in the PrlOses.h file as macros. Look for the macros that are prefixed with PVS_GUEST_VER_ (e.g. PVS_GUEST_VER_MACOS_LEOPARD).

deviceType

Device type.

pbNeeded

[out] A pointer to a variable that receives the result. PRL_TRUE indicates that the device of specified type is required. PRL_FALSE indicates otherwise.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

The function accepts the target operating system type, version, and a device type identifier. Using these parameters, it determines if the specified device is required in order for the projected virtual machine to run properly. If the device is required, you must add it to the virtual machine using the PrlVmCfg_AddDefaultDevice function. If the device is not required, you don't have to add it (i.e. it will not affect the operation of a virtual machine).

Links

PHT_VM_CONFIGURATION