Intel ZT 4901 manual RhGetSlotDomain

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.7RhGetSlotDomain

Prototype:

HSI_STATUS

RhGetSlotDomain(

IN RH_HANDLE Handle,

IN PHYSICAL_SLOT_ID PhysSlot,

OUT uint32 *pDomain);

Arguments:

Handle the handle of the current session

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