Функция StorPortGetStartIoPerfParams (storport.h)

Статья
02/27/2024

Подпрограмма StorPortGetStartIoPerfParams помещает параметры производительности для заданного запроса ввода-вывода в структуру STARTIO_PERFORMANCE_PARAMETERS .

Синтаксис

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

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in] Srb

Указатель SRB, переданный в подпрограмму HwStorStartIo , предоставленную драйвером мини-порта. Этот параметр не должен иметь значение 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 не указывает на SRB, отправленный Storport -или- Структура, на которую указывает StartIoPerfParams , недопустима, так как значение его элемента Size указывает на то, что структура слишком мала, чтобы содержать возвращаемые данные.

Код возврата

Описание

STOR_STATUS_NOT_IMPLEMENTED

Эта функция не реализована в активной операционной системе.

STOR_STATUS_SUCCESS

Указывает, что параметры производительности были сохранены в StartIoPerfParams.

STOR_STATUS_INVALID_PARAMETER

Параметр Srb или StartIoPerfParams имеет значение NULL.

-или-

Параметр HwDeviceExtension имеет значение NULL или недопустим.

-или-

Параметр Srb не указывает на SRB, отправленный Storport

-или-

Структура, на которую указывает StartIoPerfParams , недопустима, так как значение его элемента Size указывает на то, что структура слишком мала, чтобы содержать возвращаемые данные.

Начиная с Windows 8, параметр Srb может указывать на SCSI_REQUEST_BLOCK или STORAGE_REQUEST_BLOCK. Если идентификатор функции в поле ФункцияSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB является STORAGE_REQUEST_BLOCK структурой запроса.