ScsiPortNotification (NotificationType = CallEnableInterrupts or CallDisableInterrupts) 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.

Note  The SCSI port driver and SCSI miniport driver models may be altered or unavailable in the future. Instead, we recommend using the Storport driver and Storport miniport driver models.
 

Syntax


VOID ScsiPortNotification(
  _In_     SCSI_NOTIFICATION_TYPE NotificationType,
  _In_     PVOID                  HwDeviceExtension,
  _In_opt_ PHW_INTERRUPT          HwScsiXxxInterruptsCallback
);

Parameters

NotificationType [in]

Specifies the type of notification. A NotificationType of CallEnableInterrupts indicates that the miniport driver requires the operating system-specific port driver to call the miniport driver's HwScsiEnableInterruptsCallback routine. If this value is set, ScsiPortNotification requires an additional parameter: the entry point for the HwScsiEnableInterruptsCallback. The miniport driver's HwScsiInterrupt routine makes this call, after disabling interrupts on the HBA, to defer some interrupt-driven I/O processing if the HBA requires polling or stalling in the ISR. While the callback runs, system interrupts remain enabled but the miniport driver's HwScsiInterrupt routine will not be called. The HwScsiEnableInterruptsCallback is responsible for completing the deferred I/O processing and for calling ScsiPortNotification again with CallDisableInterrupts and the miniport driver's HwScsiDisableInterruptsCallback entry point..

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.

HwScsiXxxInterruptsCallback [in, optional]

Pointer to a callback routine to be called by HwScsiInterrupt. This parameter is optional.

Return value

None

Remarks

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

Requirements

Target platform

Universal

Header

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

Library

Scsiport.lib;
Storport.lib

See also

HwScsiTimer
HwScsiDisableInterruptsCallback
HwScsiEnableInterruptsCallback
ScsiPortCompleteRequest
IoWMIRegistrationControl

 

 

Send comments about this topic to Microsoft

Show: