Primera PTRobot API, Руководство пользователя

Страница: 10 / 41

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