Intel ZT 4901 Network Router User Manual


 
High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification 59
Redundant Host API
OUT RH_SLOT_DESCRIPTOR *pInfoBuffer,
IN uint32 InfoBufferSize,
OUT uint32 *pActualSize );
Arguments:
Handle the handle of the current session
PhysSlot the physical slot number below which the devices in question are nested
pSlotPath the slot path to the parent bridge for the devices
pInfoBuffer pointer to the buffer where the information about devices is placed
InfoBufferSize the size (in bytes) of the buffer initially provided for the array by the
caller
pActualSize pointer to the variable where the required size of the buffer is stored
(even if the initial size is too small and the function returns the error
HSI_STATUS_INSUFFICIENT_BUFFER).
Return Value:
HSI_STATUS_SUCCESS
returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle
HSI_NO_SUCH_DEVICE
if there are no child devices below the specified bridge
HSI_STATUS_INSUFFICIENT_BUFFER
returned if the information buffer provided by the caller is too small; in
that case, the buffer isn’t filled in but the location pointed by pActualSize
is set to a correct value to assist the caller in subsequent buffer allocation.
HSI_STATUS_NOT_SUPPORTED
returned if this function is not supported by the infrastructure
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function retrieves information about child devices below the specified bridge that occupies the
specified physical slot or is nested below it. The bridge is specified by the input parameter
SlotPath.
The following information is provided for each device as an RH_SLOT_DESCRIPTOR structure:
Size This is the size of a particular RH_SLOT_DESCRIPTOR value
including the variable-length SlotPath field.
Device addressing attributes:
PhysicalSlot The number of the physical slot in the format (shelf-ID, physical-slot-
ID); the device described by this descriptor is nested below this slot
PhysSlotDepth The number of bridging levels between this device and the physical slot.