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

Структура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

Выполняющееся действие plug and play. Этот член может иметь одно из следующих значений:

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

SrbFlags

Драйвер минипорта должен игнорировать этот элемент.

DataTransferLength

Драйвер минипорта должен игнорировать этот элемент.

TimeOutValue

Интервал (в секундах), который запрос может выполняться до того, как драйвер Storport определит, что истекло время ожидания запроса.

DataBuffer

Драйвер минипорта должен игнорировать этот элемент.

SenseInfoBuffer

Драйвер минипорта должен игнорировать этот элемент.

NextSrb

Драйвер минипорта должен игнорировать этот элемент.

OriginalRequest

Драйвер минипорта должен игнорировать этот элемент.

SrbExtension

Указатель на расширение SRB. Драйвер минипорта не должен использовать этот элемент, если для него задано значение SrbExtensionSize равным нулю в структуре HW_INITIALIZATION_DATA . Драйвер Storport не инициализирует память, на которую указывает этот член. HBA может напрямую получить доступ к данным, которые драйвер минипорта записывает в расширение SRB. Драйвер минипорта может получить физический адрес расширения SRB, вызвав подпрограмму StorPortGetPhysicalAddress .

SrbPnPFlags

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

Reserved

Зарезервировано для системного использования.

Reserved4[16]

Зарезервировано для системного использования.

Примечания

Драйвер Storport отправляет SCSI_PNP_REQUEST_BLOCK запросы к драйверу минипорта, чтобы уведомить драйвер минипорта о событиях подключаемого модуля Windows и воспроизведения, влияющих на устройства хранения, подключенные к адаптеру.

Драйвер Storport вызывает HwStorBuildIo для передачи SRB драйверу мини-порта. HwStorBuildIo проверяет член функции SRB, чтобы определить тип SRB. Если для элемента функции задано значение SRB_FUNCTION_PNP, SRB — это структура типа SCSI_PNP_REQUEST_BLOCK.

Требования

   
Заголовок storport.h (include Storport.h, Minitape.h, Srb.h)

См. также

HwStorBuildIo

SCSI_REQUEST_BLOCK

StorPortNotification