Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-117
CONFIG_GETINFO_BYNAME2_ Procedure
(G-Series and H-Series RVUs Only)
common-maxlen input
INT:value
specifies the length in bytes of the buffer pointed to by
common-info. This value
must be greater than or equal to the size of
common-info; otherwise, error is
set to 2 and
error-detail is set to 3.
common-len output
INT .EXT:ref:1
number of bytes returned by
common-info. If the value returned by this
procedure is nonzero, this parameter will be returned as zero.
specific-info:specific-maxlen output:input
STRING .EXT:ref:1, INT:value
specifies an area where the device-specific information will be returned. If
specific-info is zero or if specific-maxlen is zero, then no device-specific
data is returned. Each device type or subtype might return a different set of data.
See I/O Subsystems That Use the
specific_info Parameter on page 3-103 for a
detailed description of the structure of this buffer.
If the returned device-specific information is too large to fit into the buffer, the
actual data is truncated to fit; however,
specific-len is set to reflect the number
of bytes that would have been returned if the buffer had been large enough.
specific-len output
INT .EXT:ref:1
if
specific-info is not 0 and specific-maxlen is greater than zero, this
parameter is returned if its value is not 0. The value returned reflects the full size
of the device-specific information, even if it is larger than the
specific-maxlen
value. The actual number of bytes copied into
specific-info is the smaller of
specific-maxlen and specific-len bytes. If the value returned by this
procedure is nonzero, this parameter is returned as zero.