Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-58
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
ldevnum input
INT(32):value
specifies a logical device number that is used in one of the following ways:
•
If options.<15> is equal to 0, ldevnum designates the device for which
information is requested.
•
If options.<15> is equal to 1, the procedure begins a search of devices
starting with the logical device number immediately following
ldevnum.
See the
options parameter, later in this subsection.
On G-series releases, the logical device number of a device can change whenever
a device is configured or the system is loaded.
logical-info output
INT .EXT:ref:*
if present and if
logical-info-maxlen is not 0, points to a buffer that returns a
set of logical attributes for the specified device. The attribute values are returned
in a contiguous array.
If this parameter is present,
logical-info-maxlen and logical-info-len
must also be present.
See “Device Attributes and Value Representations,” later in this subsection, for a
description of the attributes returned in
logical-info.
logical-info-maxlen input
INT:value
specifies the length in bytes of the buffer pointed to by
logical-info. If the
buffer length is too short for the full set of device attributes, the procedure returns
as many values as will fit in the buffer.
This parameter must be present if
logical-info is present.
logical-info-len output
INT .EXT:ref:1
returns the actual length in bytes of the buffer pointed to by
logical-info.
This parameter must be present if
logical-info is present.