PrlVmCfg_IsDefaultDeviceNeeded Function

Determines if a 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

PrlApi.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 a device is required, you must add it to a virtual machine using the PrlVmCfg_AddDefaultDevice function. If a device is not required, you don't have to add it (it will not affect the operation of a virtual machine).

Links

PrlApi.h , PHT_VM_CONFIGURATION