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

  • Статья

Функция StorPortInitializePerfOpts инициализирует оптимизацию производительности, поддерживаемую драйвером мини-порта и драйвером Storport, используя структуру PERF_CONFIGURATION_DATA .

Синтаксис

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Параметры

[in] HwDeviceExtension

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

[in] Query

Если задано значение TRUE, Storport установит флаги в PerfConfigData , соответствующие оптимизации, поддерживаемые Storport. Если задано значение FALSE, Storport инициализирует оптимизации, заданные флагами в PerfConfigData.

[in, out] PerfConfigData

Указатель на структуру PERF_CONFIGURATION_DATA, предоставляемую драйвером мини-порта. Этот параметр не должен иметь значение NULL.

Возвращаемое значение

StorPortInitializePerfOpts возвращает одно из следующих значений состояния:

Код возврата Описание
STOR_STATUS_NOT_IMPLEMENTED
 Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS
 Указывает, что были применены параметры оптимизации производительности.

Или если параметр Query имеет значение TRUE, элемент Flags структуры, на который указывает PerfConfigData , содержит поддерживаемые флаги.
STOR_STATUS_UNSUCCESSFUL
 Драйвер мини-порта установил в PerfConfigData флаг, который Storport не распознал, или драйвер минипорта вызвал эту подпрограмму из-за пределов подпрограммы HwStorInitialize , предоставляемой miniport-driver.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Не удалось выделить внутренние структуры для поддержки запрошенных оптимизаций.
STOR_STATUS_INVALID_PARAMETER
 Параметр HwDeviceExtension или PerfConfigData имеет значение NULL.

Комментарии

Драйвер мини-порта может вызывать StorPortInitializePerfOpts только во время процедуры HwStorInitialize или HwStorPassiveInitializeRoutine .

Доступные оптимизации производительности зависят от версии PERF_CONFIGURATION_DATA. Если задать для элемента Versionзначение STOR_PERF_VERSION , можно выбрать все поддерживаемые оптимизации.

Требования

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

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

PERF_CONFIGURATION_DATA