dio_virtual_machine_info_c
status.i4.v = dio_virtual_machine_info_c(device_indices.i4a.r,
vm_dis.i4a.r,
property_masks.u4a.r,
errors.i2a.r,
num_devices.i4.v)
This routine returns the virtual machine information for one
device or a list of devices.
device_indices device index or array of device indices
vm_dis returned Virtual Machine device indices (DIs)
(A virtual machine device index of zero indicates
that the corresponding device does not belong
to any virtual machine.)
(A value of NULL may be passed if no virtual
machine devices are needed.)
property_masks returned logical "OR" of affected properties masks
(constants are in 'dbprops')
(A value of NULL may be passed if no property masks
are needed.)
errors returned ACNET status value or array of status values
num_devices number of devices
This function returns status values as follows:
OK success
DIO_BADARG invalid number of devices passed
DIO_MEMFAIL memory allocation failure
negative value ACNET format error indicating overall failure
positive value number of devices in error indicating partial
success
This function requires the following include files:
dbprops_h, diolib_h, acnet_errors_h
Related functions:
dio_enable_obsolete_dev_info, dio_disable_obsolete_dev_info,
error_in_list(_c)
C/C++ usage:
short errors[NUM_DEVICES];
int status;
static const int device_indices[NUM_DEVICES] = {14430, 14431};
int vm_dis[NUM_DEVICES];
int num_devices = NUM_DEVICES;
unsigned int property_masks[NUM_DEVICES];
status = dio_virtual_machine_info_c(device_indices,vm_dis,
property_masks,errors,
num_devices);