T-Kernel Specification (1.B0.02)

5.3. DEVICE MANAGEMENT FUNCTIONS 235
E QOVR Suspend disable request count limit exceeded
• ID tk_get_dev( ID devid, UB *devnm )
devid
devnm
return code
Device ID
Device name storage location
Device ID of physical device or error
Gets the device name of the device designated in devid and puts the result in devnm.
devid is the device ID of either a physical device or a logical device. If devid is a physical device,
the physical device name is put in devnm. If devid is a logical device, the logical device name is
put in devnm. devnm requires a space of L DEVNM + 1 bytes or larger.
The device ID of the physical device to which device devid belongs is passed in the return code.
E NOEXS
The device designated in devid does not exist
• ID tk_ref_dev( UB *devnm, T_RDEV *rdev )
• ID tk_oref_dev( ID dd, T_RDEV *rdev )
devnm
dd
rdev
return code
Device name
Device descriptor
Device information
Device ID or error
typedef struct t_rdev {
ATR devatr; /* device attributes */
INT blksz; /* block size of device-specific data (-1: unknown) */
INT nsub; /* subunit count */
INT subno; /* 0: physical device: 1 to nsub: subunit number+1 */
/* Implementation-dependent information may be added beyond this point.*/
} T_RDEV;
Gets device information about the device designated in devnm or dd and puts the result in rdev.
If rdev = NULL is set, the device information is not stored. nsub indicates the number of physical
device subunits belonging to the device designated in devnm or dd.
The device ID of the device designated in devnm is passed in the return code. E NOEXS The device
designated in devnm does not exist.
• INT tk_lst_dev( T_LDEV *ldev, INT start, INT ndev )
ldev
start
ndev
return code
Location of registered device information (array)
Starting number
Number to acquire
Remaining device registration count or error
typedef struct t_ldev {
ATR devatr; /* device attributes */
INT blksz; /* device-specific data block size (-1: unknown) */
INT nsub; /* subunits */
UB devnm[L_DEVNM]; /* physical device name */
/* Implementation-dependent information may be added beyond this point.*/
} T_LDEV;
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02