Guardian Procedure Calls Reference Manual (G06.25+)

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