PrlVmDev_GetEmulatedType Function

Returns the virtual device emulation type.

Syntax

PRL_RESULT PrlVmDev_GetEmulatedType(
    PRL_HANDLE hVmDev, 
    PRL_VM_DEV_EMULATION_TYPE_PTR pnEmulatedType
);

File

PrlApi.h

Parameters

hVmDev

A handle identifying the virtual device.

pnEmulatedType

[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

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

PrlApi.h, Virtual Device Functions