Redundant Host API

SlotPath -

the slot path from the root bus to the device; represented as a null-

 

terminated character string

BusNumber -

the bus number for the device. This value is 16 bit to accommodate

 

possible future extensions to PCI that allow more than 256 PCI buses in

 

the system

DeviceNumber

the device number for the device

FunctionNumber

the function number for the device

Device configuration attributes:

Attributes from VendorID to HeaderType represent the PCI configuration space attributes of the device with the same names.

The field NeedsReset has a special meaning. It is set to RESET_REQUIRED or UNKNOWN before the callback is called. The callback should set this field to RESET_NOT_REQUIRED or RESET_REQUIRED on return.

The callback should set this field to RESET_NOT_REQUIRED if it considers that no reset is necessary for this device before releasing the bus lock (for example, if the device can be set to a safe state by the device driver or is in a safe state already).

The callback should set this field to RESET_REQUIRED if it considers that the reset is necessary for the device.

No descriptors are submitted for empty slots or for the slots occupied by devices that the infrastructure considers safe for the host.

If a PCI-PCI bridge occupies some physical slot, and some devices below this bridge are in unsafe state, both descriptors for the bridge and for the devices below it in unsafe state are present. In the array, the descriptor for the bridge precedes descriptors for the devices below it.

The actions of the infrastructure after the callback returns are specified by the following rules:

If the parameter SlotResetSupported = FALSE (the infrastructure does not support per-slot resets), and at least one descriptor has NeedsReset = RESET_REQUIRED, the whole domain is reset before releasing the bus lock.

Otherwise, for each physical slot in the domain, if SlotResetSupported = TRUE, and there is a descriptor for the given physical slot in the array with NeedsReset = RESET_REQUIRED, this physical slot is reset.

Otherwise, if there is a PCI-PCI bridge device in the given physical slot, and there is at least one descriptor in the array for a device below this bridge (or for this bridge itself) with NeedsReset = RESET_REQUIRED, this physical slot is reset.

As a consequence, there is no reset if the callback clears NeedsReset in all descriptors submitted to it.

6.2.6.5RhDisableNotification

Prototype:

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

75

Page 75
Image 75
Intel ZT 4901 manual RhDisableNotification