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

Статья
02/07/2025

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

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

Синтаксис

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 о том, что запрос выполнен путем вызова подпрограммы StorPortNotification с типом уведомления 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