StorPortGetStartIoPerfParams routine

The StorPortGetStartIoPerfParams routine places the performance parameters for a given I/O request in a STARTIO_PERFORMANCE_PARAMETERS structure.

Syntax


ULONG StorPortGetStartIoPerfParams(
  _In_    PVOID                           HwDeviceExtension,
  _In_    PSCSI_REQUEST_BLOCK             Srb,
  _Inout_ PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

Parameters

HwDeviceExtension [in]

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

Srb [in]

The SRB pointer that was passed in to the HwStorStartIo routine that was supplied by the miniport driver. This parameter must not be NULL.

StartIoPerfParams [in, out]

A pointer to a STARTIO_PERFORMANCE_PARAMETERS structure that the miniport driver supplies. The miniport driver needs to set only the size of the allocated structure, as Storport will set the other members. This parameter must not be NULL.

Return value

StorPortGetStartIoPerfParams returns one of the following status values:

Return codeDescription
STOR_STATUS_NOT_IMPLEMENTED

This function is not implemented on the active operating system.

STOR_STATUS_SUCCESS

Indicates that the performance parameters have been stored in StartIoPerfParams.

STOR_STATUS_INVALID_PARAMETER

Either the Srb parameter or the StartIoPerfParams parameter is NULL.

-or-

The HwDeviceExtension parameter is NULL or not valid.

-or-

The Srb parameter is not pointing to an SRB sent by Storport

-or-

The structure pointed to by StartIoPerfParams is not valid because the value of its Size member indicates that structure is too small to contain the returned data.

 

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

Target platform

Header

Storport.h (include Storport.h)

See also

SCSI_REQUEST_BLOCK
STARTIO_PERFORMANCE_PARAMETERS
STORAGE_REQUEST_BLOCK

 

 

Send comments about this topic to Microsoft

Show: