функция обратного вызова PPUT_SCATTER_GATHER_LIST (wdm.h)
Подпрограмма 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) |