Поделиться через


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

Подпрограмма StorPortPutScatterGatherList освобождает все ресурсы, связанные со списком точечной и сборной, который ранее был создан вызовом процедуры StorPortBuildScatterGatherList .

Синтаксис

ULONG StorPortPutScatterGatherList(
  [in] PVOID                     HwDeviceExtension,
  [in] PSTOR_SCATTER_GATHER_LIST ScatterGatherList,
  [in] BOOLEAN                   WriteToDevice
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in] ScatterGatherList

Указатель на буфер, содержащий точечный или собираемый список, созданный ранее при вызове процедуры StorPortBuildScatterGatherList .

[in] WriteToDevice

Значение типа , указывающее направление завершенной передачи DMA. Значение TRUE указывает на передачу из буфера данных на устройство, а FALSE — на передачу с устройства в буфер данных.

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

StorPortPutScatterGatherList возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_NOT_IMPLEMENTED
Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS
Указывает, что подпрограмма успешно выпустила список точечной и сборной.
STOR_STATUS_INVALID_PARAMETER
Переданное значение HwDeviceExtension равно NULL.
STOR_STATUS_INVALID_IRQL
Вызов был выполнен в недопустимом IRQL.

Комментарии

Подпрограмма StorPortPutScatterGatherList не освобождает буферную память для списка точечной и сборной, так как драйвер мини-порта выделил эту память.

После возврата подпрограммы StorPortPutScatterGatherList драйвер мини-порта может повторно использовать буфер для создания нового списка точечной и сборной, повторно вызвав StorPortBuildScatterGatherList . Если драйвер минипорта завершил использование буфера для списка точечной и сборной, он должен освободить память для буфера после возврата подпрограммы StorPortPutScatterGatherList . Если драйвер мини-порта выделяет буферную память с помощью процедуры StorPortAllocatePool , он должен освободить память, вызвав подпрограмму StorPortFreePool .

Требования

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

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

StorPortBuildScatterGatherList