структура SCSI_POWER_REQUEST_BLOCK (storport.h)

Статья
02/26/2024

Структура SCSI_POWER_REQUEST_BLOCK — это специальная версия SCSI_REQUEST_BLOCK , которая используется для запросов на управление питанием.

Примечание

Модели драйверов портов SCSI и драйверов мини-портов SCSI могут быть изменены или недоступны в будущем. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .

Синтаксис

typedef struct _SCSI_POWER_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      SrbPowerFlags;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  STOR_DEVICE_POWER_STATE    DevicePowerState;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  STOR_POWER_ACTION          PowerAction;
  ULONG                      Reserved;
  UCHAR                      Reserved5[16];
} SCSI_POWER_REQUEST_BLOCK, *PSCSI_POWER_REQUEST_BLOCK;

Члены

Length

Размер структуры SCSI_POWER_REQUEST_BLOCK в байтах.

Function

Выполняемая операция. Для структуры SCSI_POWER_REQUEST_BLOCK этому элементу всегда присваивается значение SRB_FUNCTION_POWER.

SrbStatus

Состояние завершенного запроса. Этот элемент должен быть задан драйвером мини-порта, прежде чем он уведомит драйвер Storport о завершении запроса. Драйвер мини-порта уведомляет драйвер Storport о завершении запроса, вызывая функцию StorPortNotification с типом уведомления RequestComplete .

Список возможных значений для этого элемента см. в SCSI_REQUEST_BLOCK документации по WDK.

SrbPowerFlags

Флаги управления питанием. В настоящее время единственным допустимым флагом является SRB_POWER_FLAGS_ADAPTER_REQUEST, который указывает, что запрос на управление питанием предназначен для адаптера. Если этот флаг установлен, драйвер мини-порта должен игнорировать значения в PathId, TargetId и Lun.

PathId

Идентификатор порта SCSI или шины для запроса. Это значение отсчитывается от нуля.

TargetId

Целевой контроллер или идентификатор устройства в шине.

Lun

Номер логической единицы (LUN) устройства.

DevicePowerState

Значение перечислителя типа STOR_DEVICE_POWER_STATE , указывающее запрошенное состояние питания устройства.

SrbFlags