
| 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,
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 |
Device addressing attributes: | |
PhysicalSlot | The number of the physical slot in the format |
| 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 |
| accommodate possible future extensions to PCI that allow more than 256 |
| PCI buses in the system |
High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification | 57 |