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) |