Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-13
DEVICE_GETINFOBYLDEV_
Obtains the logical and physical attributes of a device.
return value:
options
#include <cextdecs(DEVICE_GETINFOBYLDEV_)>
short DEVICE_GETINFOBYLDEV_ ( long ldevnum /* i */
,[ short *logical-info ] /* o */
,[ short logical-info-maxlen ] /* i */
,[ short *logical-info-len ] /* o */
,[ short *primary-info ] /* o */
,[ short primary-info-maxlen ] /* i */
,[ short *primary-info-len ] /* o */
,[ short *backup-info ] /* o */
,[ short backup-info-maxlen ] /* i */
,[ short *backup-info-len ] /* o */
,[ long timeout ] /* i */
,[ short options ] /* i */
,[ short match-type ] /* i */
,[ short match-subtype ] /* i */
,[ char *devname ] /* i */
,[ short maxlen ] /* o:i */
,[ short *devname-len ] /* o */
,[ short *error-detail ] ); /* o */
0 = Information successfully returned.
1=Reserved.
2 = Parameter error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
3 = Bounds error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
4 = Device not found; error-detail contains a file-system error number.
5 = Buffer too small. This error applies only to devname:maxlen.
Bits 0-12 Reserved (specify 0).
Bit 13 Specifies that the procedure search for the next device that has a subtype of
match-subtype. Bit 15 of the options parameter must be set and
match-subtype must be specified when this option is used.
Bit 14 Specifies that the procedure search for the next device that has a type of
match-subtype. Bit 15 of the options parameter must be set and
match-type must be specified when this option is used.
Bit 15 Specifies that the procedure search for the next device that matches the
selection criteria.