PPUT_SCATTER_GATHER_LIST función de devolución de llamada (wdm.h)
La rutina PutScatterGatherList libera los registros de mapa asignados anteriormente y la lista de dispersión y recopilación usadas en la dispersión/recopilación de DMA.
Sintaxis
PPUT_SCATTER_GATHER_LIST PputScatterGatherList;
void PputScatterGatherList(
[in] PDMA_ADAPTER DmaAdapter,
[in] PSCATTER_GATHER_LIST ScatterGather,
[in] BOOLEAN WriteToDevice
)
{...}
Parámetros
[in] DmaAdapter
Puntero a la estructura DMA_ADAPTER devuelta por IoGetDmaAdapter que representa el adaptador de bus-master o el controlador DMA.
[in] ScatterGather
Puntero a una estructura de SCATTER_GATHER_LIST previamente devuelta por GetScatterGatherList.
[in] WriteToDevice
Indica la dirección de la transferencia de DMA: especifique TRUE para una transferencia del búfer al dispositivo y FALSE en caso contrario.
Valor devuelto
None
Observaciones
PutScatterGatherList no es una rutina del sistema a la que se puede llamar directamente por su nombre. Esta rutina solo es invocable por puntero de la dirección devuelta en una estructura de DMA_OPERATIONS . Los controladores obtienen la dirección de esta rutina mediante una llamada a IoGetDmaAdapter.
Los controladores deben llamar a PutScatterGatherList después de completar la E/S de dispersión/recopilación. Esta rutina vacía los búferes del adaptador, libera los registros de mapa y desasignación y libera los MDL asociados. Además, la rutina libera la lista de dispersión y recopilación si se asignó anteriormente por GetScatterGatherList.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de Windows. No se admite en Windows 98 o Windows Me. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |