Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-56
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Device Attributes and Value Representations
Example
Related Programming Manual
Summary
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
•
CEXTDECS (via 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.
Note. On G-series releases, 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.
#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 ] );