PPUT_SCATTER_GATHER_LIST - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wdm.h
PPUT_SCATTER_GATHER_LIST PputScatterGatherList;
VOID PputScatterGatherList(
[in] PDMA_ADAPTER DmaAdapter,
[in] PSCATTER_GATHER_LIST ScatterGather,
[in] BOOLEAN WriteToDevice
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The PutScatterGatherList routine frees the previously allocated map registers and scatter/gather list used in scatter/gather DMA.
DmaAdapter [in]Pointer to the DMA_ADAPTER structure returned by IoGetDmaAdapter that represents the bus-master adapter or DMA controller.
ScatterGather [in]Pointer to a SCATTER_GATHER_LIST structure previously returned by GetScatterGatherList.
WriteToDevice [in]Indicates the direction of the DMA transfer: specify TRUE for a transfer from the buffer to the device, and FALSE otherwise.
PutScatterGatherList is not a system routine that can be called directly by name. This routine is callable only by pointer from the address returned in a DMA_OPERATIONS structure. Drivers obtain the address of this routine by calling IoGetDmaAdapter.
Drivers should call PutScatterGatherList after completing scatter/gather I/O. This routine flushes the adapter buffers, frees the map registers, and unmaps and frees the associated MDLs. Additionally, the routine frees the scatter/gather list if it was previously allocated by GetScatterGatherList.