StorPortNotification for BusChangeDetected routine

A miniport uses the BusChangeDetected notification to indicate that a target device might have been added or removed from a dynamic bus.

Syntax


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

Parameters

NotificationType [in]

Specifies the BusChangeDetected notification type. The BusChangeDetected notification uses the additional parameter of PathId.

HwDeviceExtension [in]

A 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 mapped access ranges for the HBA. This area is available to the miniport driver immediately after the miniport driver calls StorPortInitialize. The port driver frees this memory when it removes the device.

PathId [in, optional]

Indicates the SCSI port or bus where the change was detected.

Return value

None

Remarks

After this notification is sent, the Storport driver enumerates the bus again by issuing INQUIRY commands. Bus enumeration is time-consuming and uses significant bus bandwidth, so a miniport driver should not send this notification unnecessarily.

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

Requirements

Target platform

Desktop

Header

Storport.h (include Storport.h)

Library

Storport.lib

See also

StorPortInitialize
StorPortNotification

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft