PPUT_SCATTER_GATHER_LIST funzione di callback (wdm.h)

Articolo
02/27/2024

La routine PutScatterGatherList libera i registri mappa allocati in precedenza e l'elenco di dispersione/raccolta usati in DMA a dispersione/raccolta.

Sintassi

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

void PputScatterGatherList(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] BOOLEAN WriteToDevice
)
{...}

Parametri

[in] DmaAdapter

Puntatore alla struttura DMA_ADAPTER restituita da IoGetDmaAdapter che rappresenta l'adattatore bus-master o il controller DMA.

[in] ScatterGather

Puntatore a una struttura SCATTER_GATHER_LIST restituita in precedenza da GetScatterGatherList.

[in] WriteToDevice

Indica la direzione del trasferimento DMA: specificare TRUE per un trasferimento dal buffer al dispositivo e FALSE in caso contrario.

Valore restituito

nessuno

Osservazioni

PutScatterGatherList non è una routine di sistema che può essere chiamata direttamente per nome. Questa routine è chiamabile solo dal puntatore dall'indirizzo restituito in una struttura di DMA_OPERATIONS . I driver ottengono l'indirizzo di questa routine chiamando IoGetDmaAdapter.

I driver devono chiamare PutScatterGatherList dopo aver completato l'I/O a dispersione/raccolta. Questa routine scarica i buffer dell'adattatore, libera i registri della mappa e rimuove il mapping e libera gli ELENCHI di dati mdls associati. Inoltre, la routine libera l'elenco a dispersione/raccolta se è stato allocato in precedenza da GetScatterGatherList.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive di Windows. Non supportato in Windows 98 o Windows Me.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	DISPATCH_LEVEL
Regole di conformità DDI	IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Vedi anche