Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-70
DEVICE_GETINFOBYNAME_ Procedure
(Superseded on G-Series Releases)
logical-info output
INT .EXT:ref:*
if present and if
logical-info-maxlen is not 0, 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.
The set of attributes for which values are returned in
logical-info is identical to
the set returned in the
logical-info parameter of
DEVICE_GETINFOBYLDEV_. See “Device Attributes and Value Representations”
under DEVICE_GETINFOBYLDEV_ 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.
primary-info output
INT .EXT:ref:*
if present and if
primary-info-maxlen is not 0, points to a buffer that returns a
set of physical device attributes obtained from the primary I/O process that
supports the specified device. The attribute values are returned in a contiguous
array.
If this parameter is present,
primary-info-maxlen and primary-info-len
must also be present.
The set of attributes for which values are returned in
primary-info is identical to
the set returned in the
primary-info parameter of
DEVICE_GETINFOBYLDEV_. See “Device Attributes and Value Representations”
under DEVICE_GETINFOBYLDEV_ for a description of the attributes returned in
primary-info.