функция обратного вызова 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, представляющей адаптер шины или контроллер DMA.
[in] ScatterGather
Указатель на структуру SCATTER_GATHER_LIST, возвращенную ранее GetScatterGatherList.
[in] WriteToDevice
Указывает направление передачи DMA: укажите TRUE для передачи из буфера на устройство и FALSE в противном случае.
Возвращаемое значение
Никакой
Замечания
PutScatterGatherList не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма вызывается только указателем из адреса, возвращаемого в DMA_OPERATIONS структуре. Драйверы получают адрес этой подпрограммы путем вызова IoGetDmaAdapter.
Драйверы должны вызывать PutScatterGatherList после завершения точечных операций ввода-вывода. Эта подпрограмма очищает буферы адаптера, освобождает регистры карты и отменяет сопоставления и освобождает связанные многомерные адреса. Кроме того, подпрограмма освобождает список точечной и сборной, если он был ранее выделен GetScatterGatherList.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 2000 и более поздних версиях Windows. Не поддерживается в Windows 98 или Windows Me. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| правил соответствия DDI | irqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |