ScsiPortNotification (NotificationType = WMIEvent, PathId != 0xFF)
Collapse the table of content
Expand the table of content

ScsiPortNotification (NotificationType = WMIEvent, PathId != 0xFF) 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.


VOID ScsiPortNotification(
  _In_     SCSI_NOTIFICATION_TYPE NotificationType,
  _In_     PVOID                  HwDeviceExtension,
  _In_opt_ PVOID                  WMIEvent,
  _In_opt_ UCHAR                  PathId,
  _In_opt_ UCHAR                  TargetId,
  _In_opt_ UCHAR                  Lun


NotificationType [in]

Specifies the type of notification. A NotificationType of WMIEvent indicates that the miniport driver has detected an event for which one or more WMI data consumers is registered. If this value is set, ScsiPortNotification requires at least three additional arguments: (1) a pointer to a WMI event structure, (2) the size of the event structure, and (3) the path ID of the target device if the event originated from a device, or 0Xff if the event originated from the adapter. If (3) is a path ID, ScsiPortNotification requires two additional arguments: (4) the target ID, and (5) the logical unit number (LUN) of the target device.

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.

WMIEvent [in, optional]

Pointer to event structure with information about a WMI event detected by the miniport driver. This parameter is optional.

PathId [in, optional]

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

TargetId [in, optional]

Indicates the target controller or device on the bus. This parameter is optional.

Lun [in, optional]

Indicates the logical unit number of the device. This parameter is optional.

Return value



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


Target platform



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



See also




Send comments about this topic to Microsoft

© 2016 Microsoft