The StorPortPause routine pauses an adapter for the specified period of time.

BOOLEAN
  StorPortPause(
    IN PVOID  HwDeviceExtension,
    IN ULONG  TimeOut
    );

Parameters

HwDeviceExtension

Pointer to the hardware device extension of the adapter to pause. 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 in the DeviceExtension->HwDeviceExtension member of the device object for the HBA immediately after the miniport driver calls StorPortInitialize. The port driver frees this memory when it removes the device.

TimeOut

Specifies the interval of time, in seconds, that the adapter is to be paused.

Return Value

StorPortPause returns TRUE if the miniport driver succeeded in pausing the adapter, FALSE if not.

Comments

All requests to the adapter are held until the time-out expires or the device resumes. All requests to all targets attached to the adapter will be held until the adapter is resumed or the time-out expires.

Requirements

Headers: Defined in Storport.h. Include Storport.h.

See Also

StorPortResume