функция обратного вызова PPUT_SCATTER_GATHER_LIST (wdm.h)

Статья
08/08/2023

Подпрограмма PutScatterGatherList освобождает ранее выделенные регистры карт и список точечной и сборной, используемые в DMA точечной и сборной.

Синтаксис

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

void PputScatterGatherList(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] BOOLEAN WriteToDevice
)
{...}

Параметры

[in] DmaAdapter

Указатель на структуру DMA_ADAPTER, возвращаемую IoGetDmaAdapter, которая представляет адаптер master шины или контроллер DMA.

[in] ScatterGather

Указатель на структуру SCATTER_GATHER_LIST , ранее возвращенную GetScatterGatherList.

[in] WriteToDevice

Указывает направление передачи DMA: укажите ЗНАЧЕНИЕ TRUE для передачи из буфера на устройство, в противном случае — FALSE .

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

None

Remarks

PutScatterGatherList не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма может вызываться только указателем из адреса, возвращаемого в DMA_OPERATIONS структуре. Драйверы получают адрес этой подпрограммы, вызывая IoGetDmaAdapter.

Драйверы должны вызывать PutScatterGatherList после завершения ввода-вывода точечной и сборной. Эта подпрограмма очищает буферы адаптера, освобождает регистры карты, а также отменяет сопоставление и освобождает связанные многомерные библиотеки. Кроме того, подпрограмма освобождает точечный или собираемый список, если он был ранее выделен GetScatterGatherList.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях Windows. Не поддерживается в Windows 98 или Windows Me.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
IRQL	DISPATCH_LEVEL
Правила соответствия DDI	IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

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