Функция StorPortGetScatterGatherList (storport.h)

  • Статья

Подпрограмма StorPortGetScatterGatherList извлекает связанный список точечной и сборной для указанного блока запросов SCSI (SRB).

Синтаксис

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства. Это область хранения HBA, которую драйвер порта выделяет и инициализирует от имени драйвера мини-порта. Драйверы мини-портов обычно хранят сведения, относящиеся к HBA, в этом расширении, такие как состояние адаптера безопасности и сопоставленные диапазоны доступа для HBA. Эта область доступна для мини-порта сразу после того, как драйвер минипорта вызывает StorPortInitialize. Драйвер порта освобождает эту память при удалении устройства.

[in] Srb

Указатель на SRB, для которого должен быть создан список точечного сбора.

Возвращаемое значение

StorPortGetScatterGatherList возвращает указатель на точечный список или список сбора.

Комментарии

Эта подпрограмма предоставляется вместе с библиотекой драйверов Storport. В библиотеке портов SCSI не предусмотрена параллельная подпрограмма.

Указатель на возвращаемый список точечных и сборных данных действителен только до завершения SRB.

Драйверу мини-порта не нужно освобождать память для списка точечной и сборной, возвращаемого StorPortGetScatterGatherList .

Драйвер мини-порта не должен изменять список точечной и сборной.

Начиная с Windows 8, параметр Srb может указывать на SCSI_REQUEST_BLOCK или STORAGE_REQUEST_BLOCK. Если идентификатор функции в поле ФункцияSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB является STORAGE_REQUEST_BLOCK структурой запроса.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
Библиотека Storport.lib

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

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

STOR_SCATTER_GATHER_ELEMENT

STOR_SCATTER_GATHER_LIST