PTRobot API
Page 10 of 41
© 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of
their respective companies.
//
robotically controlled. The calling application
//
needs to use PTRobot_SetRoboticDrive to resolve
//
this
error.
//
///////////////////////////
DWORD WINAPI
PTRobot_EnumDrives
(HANDLE hRobot, HANDLE
*
phDrives, DWORD
*
pdwNumDrives);
2.1.6
PTRobot_EnumDrivesWithList
///////////////////////////
//
// PTRobot_EnumDrivesWithList
//
// Description:
//
Function to pass down drives enumerated by the calling app for
//
PTRobot to use in determining which drives are robotically controlled.
//
This is an alternative function to PTRobot_EnumDrives.
// Params:
//
hRobot
Handle to the robot.
//
phDrives
points to an array of HANDLEs that contains the
//
drive handles of the drives in the system
//
pdwNumDrives
points to a DWORD containing the number of HANDLEs
//
in the phDrives array.
//
phRobotDrives
points to an array of HANDLEs that contains the
//
drive handles of the drives contained in this robot.
//
pdwNumRobotDrives points to a DWORD containing the number of drives
//
in the phRobotDrives array.
//
// Notes:
//
phRobotDrives and pdwNumRobotDrives will be updated upon successful
//
completion of this command. phRobotDrives will contain
//
handles to drives contained in the robot. pdwNumRobotDrives will be
//
updated with the number of drives found.
//
//
The format of the drive handle is the following:
//
//
The least significant byte should contain the drive letter, the
//
other three bytes should contain the SCSI triple. The drive can
//
be identified by either of these methods.
//
//
For Example: 0x01030044 would identify a drive with:
//
Host=1, ID = 3, LUN = 0, and a drive letter of "D"
//
//
To identify the same drive the client could pass down
//
0x01030000, 0x00000044, or 0x01030044.
//
//
This function should be called instead of PTRobot_EnumDrives if the
//
calling application wants to enumerate the drives and have PTRobot
//
select the Robotically controlled drives from the list the calling
//
application
provides.
//
// Return:
//
PTROBOT_OK if Successful
//
PTROBOT_SEQUENCE if this command is called out of sequence or after
//
PTRobot_EnumDrives
