Функция 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 |