PPUT_SCATTER_GATHER_LIST función de devolución de llamada (wdm.h)

Artículo
02/27/2024

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)

Consulte también