Intel ZT 4901 Network Router User Manual


 
50 High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification
Redundant Host API
Domain the domain number
pSlotNumbersArray pointer to the array where the list of slot numbers for the specified
domain is placed
ArraySize the size (in items of type PHYSICAL_SLOT_ID) of the buffer initially
provided for the array by the caller
pActualSize pointer to the variable where the actual number of items in the list 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_STATUS_INSUFFICIENT_BUFFER
returned if the buffer provided for the array by the caller is too small; in
that case, the array isn’t filled in but the location pointed by pActualSize
is set to correct value to assist the caller in subsequent buffer allocation.
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function retrieves the list of physical slot numbers for the specified domain. Each physical slot
number is an arbitrary (but system-wide, unique) combination of ShelfID and SlotID values.
Before the call, the caller should allocate a buffer that can accommodate a sufficient number of
PHYSICAL_SLOT_ID structures, and pass its address in the pSlotNumbersArray parameter. The
parameter ArraySize should be set equal to the size of the buffer in PHYSICAL_SLOT_ID items.
The slot count returned from “RhGetDomainSlotCount” can be used as the value of this parameter.
On return, the function populates the buffer with the array of slot numbers for all slots in the
domain, and places the actual number of returned slot numbers into the output parameter
*pActualSize. If the specified ArraySize is too small, the function returns status
HSI_STATUS_INSUFFICIENT_BUFFER, and doesn’t populate the buffer, but still sets the
parameter *pActualSize to the required size of the buffer.
6.2.3.7 RhGetSlotDomain
Prototype:
HSI_STATUS
RhGetSlotDomain(
IN RH_HANDLE Handle,
IN PHYSICAL_SLOT_ID PhysSlot,
OUT uint32 *pDomain);
Arguments:
Handle the handle of the current session