StorPortGetStartIoPerfParams 函数 (storport.h)

  • 项目

StorPortGetStartIoPerfParams 例程将给定 I/O 请求的性能参数置于STARTIO_PERFORMANCE_PARAMETERS结构中。

语法

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

参数

[in] HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

[in] Srb

传递到微型端口驱动程序提供的 HwStorStartIo 例程的 SRB 指针。 此参数不得为 NULL。

[in, out] StartIoPerfParams

指向微型端口驱动程序提供的STARTIO_PERFORMANCE_PARAMETERS结构的指针。 微型端口驱动程序只需设置已分配结构的大小，因为 Storport 将设置其他成员。 此参数不得为 NULL。

返回值

StorPortGetStartIoPerfParams 返回以下状态值之一：

返回代码 说明
STOR_STATUS_NOT_IMPLEMENTED
 此函数未在活动操作系统上实现。
STOR_STATUS_SUCCESS
 指示性能参数已存储在 StartIoPerfParams 中。
STOR_STATUS_INVALID_PARAMETER
 Srb 参数或 StartIoPerfParams 参数为 NULL。

-或-

HwDeviceExtension 参数为 NULL 或无效。

-或-

Srb 参数未指向 Storport 发送的 SRB

-或-

StartIoPerfParams 指向的结构无效，因为其 Size 成员的值指示结构太小，无法包含返回的数据。

注解

从 Windows 8 开始，Srb 参数可能指向 SCSI_REQUEST_BLOCK 或 STORAGE_REQUEST_BLOCK。 如果 Srb 的“函数”字段中的函数标识符SRB_FUNCTION_STORAGE_REQUEST_BLOCK，则 SRB 是STORAGE_REQUEST_BLOCK请求结构。

要求

要求 值
目标平台 通用
标头 storport.h (包括 Storport.h)

另请参阅

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK