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

перечисление SCSI_UNIT_CONTROL_TYPE (storport.h)

  • Статья

Перечисление SCSI_UNIT_CONTROL_TYPE содержит операции управления единицами, где каждый тип элемента управления инициирует действие на единице драйвером мини-порта. Storport задает тип элемента управления при вызове подпрограммы HwStorUnitControl минипорта.

Синтаксис

typedef enum _SCSI_UNIT_CONTROL_TYPE {
  ScsiQuerySupportedUnitControlTypes,
  ScsiUnitUsage,
  ScsiUnitStart,
  ScsiUnitPower,
  ScsiUnitPoFxPowerInfo,
  ScsiUnitPoFxPowerRequired,
  ScsiUnitPoFxPowerActive,
  ScsiUnitPoFxPowerSetFState,
  ScsiUnitPoFxPowerControl,
  ScsiUnitRemove,
  ScsiUnitSurpriseRemoval,
  ScsiUnitRichDescription,
  ScsiUnitQueryBusType,
  ScsiUnitQueryFruId,
  ScsiUnitReportInternalData,
  ScsiUnitKsrPowerDown,
  ScsiUnitControlMax,
  MakeUnitControlTypeSizeOfUlong
} SCSI_UNIT_CONTROL_TYPE, *PSCSI_UNIT_CONTROL_TYPE;

Константы

 
ScsiQuerySupportedUnitControlTypes
Сообщает об операциях управления единицами, реализованных драйвером мини-порта. Мини-порт должен поддерживать этот тип элемента управления.

Драйвер Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру SCSI_SUPPORTED_CONTROL_TYPE_LIST после инициализации адаптера HBA, но до первого ввода-вывода.

Драйвер мини-порта заполняет структуру SCSI_SUPPORTED_CONTROL_TYPE_LIST поддерживаемыми операциями. После возврата HwStorUnitControl из этого вызова драйвер Storport вызывает HwStorUnitControl драйвера мини-порта только для операций, поддерживаемых мини-портом.
ScsiUnitUsage
Уведомляет мини-порт о том, используется ли логическая единица для поддерживаемых типов использования. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру STOR_UC_DEVICE_USAGE . Storport будет вызывать HwStorUnitControl отдельно для каждого поддерживаемого типа использования.
ScsiUnitStart
Уведомляет мини-порт о запуске устройства. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_ADDR_BTL8 адрес начальной единицы.
ScsiUnitPower
Сообщает о состоянии включения или выключения блока. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру STOR_UNIT_CONTROL_POWER . Если мини-порт поддерживает этот тип элемента управления, он не получит блок запроса хранилища с SRB_FUNCTION_POWER.
ScsiUnitPoFxPowerInfo
Уведомляет мини-порт, если в компоненте блока включено или отключено управление питанием бездействующее. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_POFX_UNIT_POWER_INFO структуру. Мини-порт должен вызывать StorPortInitializePoFxPower в этом элементе управления, если включено управление бездействующее питание и поддерживается ли управление питанием во время выполнения для устройства.
ScsiUnitPoFxPowerRequired
Уведомляет мини-порт о том, требуется ли питание для компонента блока. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими наSTOR_POFX_POWER_REQUIRED_CONTEXT структуру.
ScsiUnitPoFxPowerActive
Уведомляет мини-порт о том, что компонент блока активен или простаивает. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_POFX_ACTIVE_CONTEXT структуру.
ScsiUnitPoFxPowerSetFState
Уведомляет мини-порт о том, что компоненту единицы задано заданное функциональное состояние питания (F-состояние). Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_POFX_FSTATE_CONTEXT структуру. Минипорт должен поддерживать этот тип элемента управления, если в вызове StorPortInitializePoFxPower задано несколько F-состояний.
ScsiUnitPoFxPowerControl
Запрашивает выполнение мини-порта частной операции управления питанием, инициированной для устройства подключаемым модулем питания (PEP). Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_POFX_POWER_CONTROL структуру.
ScsiUnitRemove
Уведомляет мини-порт о том, что устройство было удалено. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_ADDR_BTL8 адрес удаленной единицы.
ScsiUnitSurpriseRemoval
Уведомляет мини-порт о том, что устройство было неожиданно удалено. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на STOR_ADDR_BTL8 адрес единицы, которая была удалена неожиданностью.
ScsiUnitRichDescription
Мини-порт может поддерживать эту функцию, если устройство сообщает больше идентификатора поставщика, номера модели или редакции встроенного ПО, чем указано в спецификации SCSI. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру STOR_RICH_DEVICE_DESCRIPTION .
ScsiUnitQueryBusType
Запрашивает, хочет ли мини-порт указать тип шины для заданной логической единицы (LUN). Как правило, тип шины LUN и контроллера имеют один и тот же тип шины, но не всегда. Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру STOR_UNIT_CONTROL_QUERY_BUS_TYPE . Доступно в Windows 10 версии 2004 и более поздних.

ПРИМЕЧАНИЕ

В Windows 10 версии 21H1 и более поздних, Storport отправляет этот элемент управления только в том случае, если минипорт ранее также назывался StorPortSetFeatureList в своей подпрограмме HwFindAdapter с указанным параметром StorportFeatureBusTypeUnitControl.
ScsiUnitQueryFruId
Запрашивает идентификатор блока замены сбоя (FRU). Если мини-порт поддерживает этот тип элемента управления, Storport вызывает HwStorUnitControl с этим типом элемента управления и параметрами , указывающими на структуру STOR_FRU_ID_DESCRIPTION . Доступно в Windows 10 версии 21H1 и более поздних.

ПРИМЕЧАНИЕ

Storport отправляет этот элемент управления, только если минипорт ранее также назывался StorPortSetFeatureList в своей подпрограмме HwFindAdapter с указанным параметром StorportFeatureFruIdUnitControl .
ScsiUnitReportInternalData
Зарезервировано для системного использования. Доступно начиная с Windows 11 версии 22H2.
ScsiUnitKsrPowerDown
Зарезервировано для внутреннего использования. Не используйте.
ScsiUnitControlMax
Максимальное значение типа элемента управления.
MakeUnitControlTypeSizeOfUlong
Делает это перечисление размером ULONG.

Комментарии

Минипорт сообщает, какие типы элементов управления он поддерживает, когда Storport вызывает подпрограмму HwStorUnitControl мини-порта с типом элемента управления ScsiQuerySupportedControlTypes. Для тех типов элементов управления, которые поддерживает минипорт, Storport вызывает HwStorUnitControl со значением SCSI_UNIT_CONTROL_TYPE , которое указывает операцию управления единицей, выполняемую мини-портом.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Верхняя часть storport.h

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

HwStorUnitControl