Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PHT_HW_GENERIC_DEVICE
Functions  Functions by Handle  Legend

PHT_HW_GENERIC_DEVICE is a base handle used to manage physical devices. A physical device can be a real physical device installed on the host computer or, in some cases, a device in a virtual machine as seen by the guest operating system (this handle should not be confused with handles that are used to manage virtual devices).

Description

To obtain a handle identifying a specific device of a particular type, an appropriate function from the PHT_SERVER_CONFIG group must be used. For example, to obtain a handle identifying a floppy disk drive, the PrlSrvCfg_GetFloppyDisk function must be used; to obtain an optical disk drive handle, use the PrlSrvCfg_GetOpticalDisk (other functions are named similarly). Some of these functions obtain a handle of type PHT_HW_GENERIC_DEVICE described here. Others obtain a different handle specific to the device type. These other handles are derived from the PHT_HW_GENERIC_DEVICE handle and contain additional functions. For example, the PHT_HW_HARD_DISK handle is derived from PHT_HW_GENERIC_DEVICE and contains additional functions, such as functions for getting the disk partition information. All of the functions provided by the PHT_HW_GENERIC_DEVICE handle can also be used with derived handles, which means that a derived handle can be passed as a parameter to any of the functions described in this section. 

The following is the list of handles that are derived from PHT_HW_GENERIC_DEVICE: 

PHT_HW_HARD_DISK 

PHT_HW_HARD_DISK_PARTITION 

PHT_HW_NET_ADAPTER 

PHT_HW_GENERIC_PCI_DEVICE 

Functions
 
Name 
Description 
 
Determines whether a virtual machine can directly use a device, such as a PCI device through IOMMU technology (e.g. 
 
Obtains the device ID. 
 
Obtains the device name. 
 
Obtains the device type. 
 
Returns the UUIDs of VM of the specified index that are currently using the device. 
 
Determine number of UUIDs of VMs that are currently using the device. 
 
Determines whether the device is connected to a virtual machine. 
 
Allows to specify whether a virtual machine can directly use a device, such as a PCI device through IOMMU technology (e.g. 
Links
© 2021 Parallels International GmbH. All rights reserved.