StorPortDeviceBusy function (storport.h)

Article
10/21/2021

The StorPortDeviceBusy routine notifies the port driver that the specified logical unit is currently busy, handling outstanding requests.

Syntax

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

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 given buses.

[in] Lun

Identifies the logical unit for the given target controller or device.

[in] RequestsToComplete

Indicates the number of requests that the logical unit must complete before resuming I/O requests to the miniport driver. If RequestsToComplete is greater than the number of currently outstanding requests, the Storport driver will complete all outstanding requests to the logical unit before resuming requests.

Return value

StorPortDeviceBusy returns TRUE if the miniport driver succeeded in notifying the port driver, FALSE if not.

Remarks

No error log is generated when a device is busy.

The port driver will not issue any new requests to the logical unit until the logical unit's queue has been drained to a sufficient level where processing can continue.

Requirements

Requirement	Value
Target Platform	Universal
Header	storport.h (include Storport.h)
Library	Storport.lib