Guardian Procedure Calls Reference Manual

DEVICE_GETINFOBYLDEV_ Procedure (Superseded on G-series RVUs)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Device Attributes and Value Representations
Considerations
Example
Related Programming Manual
Summary
NOTE: On G-series RVUs, this procedure is supported for compatibility with previous software
and should not be used for new development. This procedure cannot obtain all of the physical
attributes of a device. For new development, use the CONFIG_GETINFO_BYLDEV_ procedure.
The DEVICE_GETINFOBYLDEV_ procedure obtains the physical and logical attributes of a device.
The device is either specified by logical device number or determined by a search.
Syntax for C Programmers
#include <cextdecs(DEVICE_GETINFOBYLDEV_)>
short DEVICE_GETINFOBYLDEV_ ( __int32_t ldevnum
,[ short *logical-info ]
,[ short logical-info-maxlen ]
,[ short *logical-info-len ]
,[ short *primary-info ]
,[ short primary-info-maxlen ]
,[ short *primary-info-len ]
,[ short *backup-info ]
,[ short backup-info-maxlen ]
,[ short *backup-info-len ]
,[ __int32_t timeout ]
,[ short options ]
,[ short match-type ]
,[ short match-subtype ]
,[ char *devname ]
,[ short maxlen ]
,[ short *devname-len ]
,[ short *error-detail ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
• The parameter maxlen specifies the maximum length in bytes of the character string pointed
to by devname. The actual length of the name returned in devname is returned in
devname-len. All three of these parameters must either be supplied or be absent.
300 Guardian Procedure Calls (D-E)