Collapse All
Parallels C API Reference Guide
Virtual Device Functions
Functions Common Functions Legend

This section describes common virtual device management functions.

Description

Common virtual device management functions can operate on virtual devices of the following types:

PHT_VIRTUAL_DEV_FLOPPY

PHT_VIRTUAL_DEV_HARD_DISK

PHT_VIRTUAL_DEV_NET_ADAPTER

PHT_VIRTUAL_DEV_OPTICAL_DISK

PHT_VIRTUAL_DEV_PARALLEL_PORT

PHT_VIRTUAL_DEV_SERIAL_PORT

PHT_VIRTUAL_DEV_SOUND

PHT_VIRTUAL_DEV_USB_DEVICE

Each common function accepts a handle of type PRL_HANDLE identifying the virtual device to operate on. The actual handle passed can be of any type from the list above. In addition to common function described here, most of the individual virtual devices have functions specific to their respective types. For device-type specific functions, follow links to virtual device handles in the list above.

Functions
Name
Description
The PrlVmDev_Connect function allows to connect virtual devices while the virtual machine is running.
Copies a virtual device image to another custom location.
Creates a new virtual device handle not bound to any virtual machine.
Physically creates a virtual device image on the host.
Allows to disconnect a device while the virtual machine is running.
Returns the description of a specified virtual device.
Returns the virtual device emulation type.
Returns the virtual device user friendly name.
Returns the virtual device interface type (IDE or SCSI).
Returns virtual device image path.
Returns an index identifying the virtual device.
Returns the virtual device output file.
Returns the virtual device stack index (position at the controller (IDE or SCSI) bus).
Returns the virtual device system name.
Returns the type of the specified device.
Checks if the specified virtual device is connected.
Determines if the specified device is enabled.
Determines if the passthrough mode is enabled for the specified mass storage device.
Determines if the specified virtual device is a remote device.
Removes the specified virtual device handle from the parent virtual machine list.
Resize a virtual device image.
Connects the specified virtual device.
Automatically generates and assigns a stack index to a virtual device (a corresponding device interface, IDE or SCSI, has to be set in advance).
Sets the description for a specified virtual device.
Sets the specified virtual device emulation type.
Enables the specified virtual device..
Sets virtual device user-friendly name.
Sets the virtual device interface type (IDE or SCSI).
Sets the virtual device image path.
Sets an index identifying the virtual device.
Sets the virtual device output file.
Enables the passthrough mode for the specified mass storage device (optical ot hard disk).
Changes the "remote" flag for the specified device.
Sets the virtual device stack index (position at the IDE or SCSI controller bus).
Sets virtual device system name.
Links
Copyright © 1999-2011 Parallels Holdings, Ltd. and its affiliates. All rights reserved.
What do you think about this topic? Send feedback!