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

2025-02-07

СтруктураSCSI_PNP_REQUEST_BLOCK — это специальная версия SCSI_REQUEST_BLOCK, которая используется для запросов plug and play (PNP).

Заметка

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

Синтаксис

typedef struct _SCSI_PNP_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      PnPSubFunction;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  STOR_PNP_ACTION            PnPAction;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  ULONG                      SrbPnPFlags;
  ULONG                      Reserved;
  UCHAR                      Reserved4[16];
} SCSI_PNP_REQUEST_BLOCK, *PSCSI_PNP_REQUEST_BLOCK;

Члены

Length

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

Function

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

SrbStatus

Состояние завершенного запроса. Минипорт-драйвер должен задать это значение перед уведомлением драйвера Storport о завершении запроса. Минипорт-драйвер уведомляет драйвер Storport о том, что запрос завершился путем вызова подпрограммыstorPortNotificationStorPortNotification с типом уведомления RequestComplete. Список возможных значений состояния см. в SCSI_REQUEST_BLOCK.

PnPSubFunction

Этот элемент в настоящее время не используется. Мини-порты игнорируют этот элемент.

PathId

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

TargetId

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

Lun

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

PnPAction

Действие подключаемого модуля и воспроизведения для выполнения. Этот элемент может иметь одно из следующих значений:

Ценность	Значение
StorStartDevice (0x00)	Запустите устройство.
StorRemoveDevice (0x02)	Удалите устройство.
StorStopDevice (0x04)	Остановите устройство.
StorQueryCapabilities (0x09)	Запрос возможностей устройства.
StorQueryRequirements (0x0B)	Запрос требований к ресурсам для устройства.
StorFilterResourceRequirements (0x0D)	Фильтрация требований к ресурсам для устройства.
StorSupriseRemoval (0x17)	Неожиданное удаление устройства. Это значение было добавлено в Windows 7.

SrbFlags