PPUT_SCATTER_GATHER_LIST função de retorno de chamada (wdm.h)

A rotina PutScatterGatherList libera os registros de mapa alocados anteriormente e a lista de dispersão/coleta usada no DMA de dispersão/coleta.

Sintaxe

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

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

Parâmetros

[in] DmaAdapter

Ponteiro para a estrutura DMA_ADAPTER retornada por IoGetDmaAdapter que representa o adaptador de master de barramento ou o controlador de DMA.

[in] ScatterGather

Ponteiro para uma estrutura SCATTER_GATHER_LIST retornada anteriormente por GetScatterGatherList.

[in] WriteToDevice

Indica a direção da transferência de DMA: especifique TRUE para uma transferência do buffer para o dispositivo e FALSE caso contrário.

Retornar valor

Nenhum

Comentários

PutScatterGatherList não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina só pode ser chamada pelo ponteiro do endereço retornado em uma estrutura de DMA_OPERATIONS . Os drivers obtêm o endereço dessa rotina chamando IoGetDmaAdapter.

Os drivers devem chamar PutScatterGatherList depois de concluir a E/S de dispersão/coleta. Essa rotina libera os buffers do adaptador, libera os registros de mapa e cancela omaps e libera os MDLs associados. Além disso, a rotina libera a lista de dispersão/coleta se ela foi alocada anteriormente por GetScatterGatherList.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores do Windows. Sem suporte no Windows 98 ou no Windows Me.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	DISPATCH_LEVEL
Regras de conformidade da DDI	IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Confira também

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST