Filter
Top Products
High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification 57
Redundant Host API
PhysSlot obtains information for given physical slot number
pInfoBuffer pointer to the buffer where the information 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 the specified slot is empty
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 the device in the specified physical slot. If the device
consists of several PCI functions, several information records are placed in the buffer, one for each
PCI function. The following information is provided in each record, all of type
RH_SLOT_DESCRIPTOR:
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 resides in this slot
PhysSlotDepth The number of bridging levels between this device and the physical slot;
this value is 0 for this call (since this call returns information about
devices directly placed in the physical slots)
OwningHost The number of the host that currently owns the domain this device
belongs to
RootBusNumber The PCI bus number of the root bus of the PCI hierarchy the device
resides in; is 0 for single-root PCI hierarchies. This value is 16 bit to
accommodate possible future extensions to PCI that allow more than 256
PCI buses in the system