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

Статья
02/07/2025

Программа 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 (include Storport.h)
IRQL	DISPATCH_LEVEL
правил соответствия DDI	storPortIrql(storport)

См. также

StorPortBuildScatterGatherList

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