Поделиться через


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

Подпрограмма 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 указывает на то, что структура слишком мала, чтобы содержать возвращаемые данные.

Комментарии

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

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)

См. также раздел

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK