Intel ZT 4901 manual Hsinosuchdevice, If the specified slot is empty, Rhslotdescriptor

	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

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