Export (0) Print
Expand All

HwStorStateChange routine

A miniport-provided callback that is called after a notification from StorPortStateChangeDetected is processed.

Syntax


VOID HwStorStateChange(
  _In_      IN PVOID DeviceExtension,
  _In_opt_  PVOID Context,
  _In_      SHORT AddressType,
  _In_      PVOID Address,
  _In_      ULONG Status
);

Parameters

DeviceExtension [in]

A pointer to the miniport driver's per-HBA storage area.

Context [in, optional]

The context supplied as HwStateChangeContext by the miniport in the call to StorPortStateChangeDetected.

AddressType [in]

The type of the address in Address.

Address [in]

A pointer to a STOR_ADDRESS structure for the entity whose state change was processed.

Status [in]

The processing status for the state change notification.

Return value

None.

Remarks

The HwStorStateChange is called with the StartIo lock acquired by Storport.

This callback enables miniports to do any additional processing that is needed after hardware addition or removal. If a hardware change occurs on the HBA port or bus, the miniport can call StorPortStateChangeDetected to alert the system of the event.

If the value for Status is < 0x80000000, then the notification processing was successful. Otherwise, the notification process failed.

The name HwStorStateChange is just a placeholder for the miniport function that is pointed to by the HwStateChange parameter of StorPortStateChangeDetected. The actual prototype of this routine is defined in Storport.h as follows:


typedef
VOID
HW_STATE_CHANGE (
    _In_ PVOID HwDeviceExtension,
    _In_opt_ PVOID Context,
    _In_ SHORT AddressType,
    _In_ PVOID Address,
    _In_ ULONG Status
    );

Requirements

Version

Available in Windows 8 and later versions of Windows.

Header

Storport.h (include Storport.h)

IRQL

DISPATCH

See also

STOR_ADDRESS
StorPortStateChangeDetected

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft