StorPortPauseDevice function (storport.h)

The StorPortPauseDevice routine pauses a specific logical unit device for the specified period of time.

Syntax

STORPORT_API BOOLEAN StorPortPauseDevice(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
       ULONG Timeout
);

Parameters

[in] HwDeviceExtension

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.

[in] PathId

Identifies the SCSI bus.

[in] TargetId

Identifies the target controller or device on the bus.

[in] Lun

Identifies the logical unit number of the target device.

Timeout

Contains the interval of time that the device is to be paused, in seconds.

Return value

StorPortPauseDevice returns TRUE if the miniport driver succeeded in pausing the device, FALSE if not.

Remarks

When the time-out expires, I/O requests to the device will be resumed.

Requirements

See also

StorPortResumeDevice