StorPortGetSystemAddress function (storport.h)

Article
02/22/2024

The StorPortGetSystemAddress routine returns a virtual address in system space for the data buffer of the specified SCSI request block (SRB).

Syntax

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

[in] Srb

A pointer to a SCSI_REQUEST_BLOCK structure.

[out] SystemAddress

A pointer to receive the virtual address of the data buffer.

Return value

StorPortGetSystemAddress returns one of the following status codes:

Return code	Description
STOR_STATUS_NOT_IMPLEMENTED	This function is not implemented on the active operating system.
STOR_STATUS_SUCCESS	Indicates that the system address was obtained successfully.
STOR_STATUS_INVALID_PARAMETER	This status code is caused by one of the following conditions: The SRB does not have an associated data buffer. The pointer to receive the virtual address is NULL.
STOR_STATUS_INVALID_IRQL	The call was made at an invalid IRQL.
STOR_STATUS_INSUFFICIENT_RESOURCES	The attempt to map the data buffer to system space failed.

Remarks

Starting in Windows 8, the Srb parameter may point to either SCSI_REQUEST_BLOCK or STORAGE_REQUEST_BLOCK. If the function identifier in the Function field of Srb is SRB_FUNCTION_STORAGE_REQUEST_BLOCK, the SRB is a STORAGE_REQUEST_BLOCK request structure.

Requirements

Requirement	Value
Minimum supported client	This routine is available starting with Windows Server 2003 with SP2.
Target Platform	Universal
Header	storport.h (include Storport.h)
IRQL	<=DISPATCH_LEVEL
DDI compliance rules	StorPortIrql(storport)