PrlVmDev_SetEmulatedType Function

Sets the specified virtual device emulation type.

Syntax

PRL_RESULT PrlVmDev_SetEmulatedType(
    PRL_HANDLE hVmDev, 
    PRL_VM_DEV_EMULATION_TYPE nEmulatedType
);

File

PrlApiVm.h

Parameters

hVmDev

A handle identifying the virtual device.

nEmulatedType

The emulation type to set.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Emulation types are defined in the PRL_VM_DEV_EMULATION_TYPE enumeration. The following describes emulation types used for different types of virtual devices:

PHT_VIRTUAL_DEV_FLOPPY: PDT_USE_REAL_DEVICE, PDT_USE_IMAGE_FILE.
PHT_VIRTUAL_DEV_HARD_DISK: PDT_USE_REAL_DEVICE, PDT_USE_IMAGE_FILE.
PHT_VIRTUAL_DEV_OPTICAL_DISK: PDT_USE_REAL_DEVICE, PDT_USE_IMAGE_FILE.
PHT_VIRTUAL_DEV_SERIAL_PORT: PDT_USE_REAL_DEVICE, PDT_USE_OUTPUT_FILE, PDT_USE_OTHER (for socket mode).
PHT_VIRTUAL_DEV_PARALLEL_PORT: PDT_USE_REAL_DEVICE, PDT_USE_OUTPUT_FILE, PDT_USE_OTHER (for printer mode).
PHT_VIRTUAL_DEV_NET_ADAPTER: PDT_USE_REAL_DEVICE (host only network), PDT_USE_IMAGE_FILE (shared network). PDT_USE_OUTPUT_FILE (bridget ethernet)
PHT_VIRTUAL_DEV_SOUND: PDT_USE_REAL_DEVICE (AC'97), PDT_USE_IMAGE_FILE (Creative).
PHT_VIRTUAL_DEV_USB_DEVICE: PDT_USE_REAL_DEVICE

Links

Virtual Device Functions