Intel ZT 4901 manual Handle Handle of the current session PhysSlot

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.

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification 59