Expand Minimize

ScsiPortNotification (NotificationType = BusChangeDetected) routine

The ScsiPortNotification routine informs the operating system-specific port driver of certain events, such as when a miniport driver completes a request or is ready to start another SRB, as well as when the HBA indicates certain SCSI error conditions that occurred during an operation.

Syntax


VOID ScsiPortNotification(
  _In_      SCSI_NOTIFICATION_TYPE NotificationType,
  _In_      PVOID HwDeviceExtension,
  _In_opt_  UCHAR PathId
);

Parameters

NotificationType [in]

Specifies the type of notification. A NotificationType of BusChangeDetected indicates that a target device might have been added or removed from a dynamic bus. If this value is set, ScsiPortNotification requires an additional parameter: the path ID of the bus on which the change was detected. After this notification, the port driver reenumerates the bus by issuing INQUIRY commands. Bus enumeration is time-consuming and ties up the bus, so a miniport driver should not send this notification unnecessarily.

HwDeviceExtension [in]

Pointer to the hardware device extension. This is a per-HBA storage area that the port driver allocates and initializes on behalf of the miniport driver. Miniport drivers usually store HBA-specific information in this extension, such as the state of the HBA and the HBA's mapped access ranges. This area is available to the miniport driver in the DeviceExtension->HwDeviceExtension member of the HBA's device object immediately after the miniport driver calls ScsiPortInitialize. The port driver frees this memory when it removes the device.

PathId [in, optional]

Indicates the SCSI port or bus for the request. This parameter is optional.

Return value

None

Remarks

For information about the effects of other notification types, see ScsiPortNotification.

Requirements

Header

Srb.h (include Miniport.h or Scsi.h)

See also

HwScsiTimer
HwScsiDisableInterruptsCallback
HwScsiEnableInterruptsCallback
ScsiPortCompleteRequest
IoWMIRegistrationControl

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft