Compartilhar via


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 de DMA_ADAPTER retornada por IoGetDmaAdapter que representa o adaptador mestre do barramento ou o controlador DMA.

[in] ScatterGather

Ponteiro para uma estrutura de 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.

Valor de retorno

Nenhum

Observações

PutScatterGatherList não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina só pode ser chamada por 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
de cliente com suporte mínimo Disponível no Windows 2000 e versões posteriores do Windows. Não há suporte para Windows 98 ou Windows Me.
da Plataforma de Destino Área de trabalho
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL DISPATCH_LEVEL
regras de conformidade de DDI IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Consulte também

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST