StorPortGetStartIoPerfParams 函式（storport.h）

2025-02-07

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 成員的值表示結構太小而無法包含傳回的數據。

傳回碼

描述

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 要求結構。