PFREE_ADAPTER_CHANNEL função de retorno de chamada (wdm.h)
A rotina FreeAdapterChannel libera o controlador DMA do sistema quando um driver conclui todas as operações de DMA necessárias para atender ao IRP atual.
Sintaxe
PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;
void PfreeAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
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.
Valor de retorno
Nenhum
Observações
FreeAdapterChannel 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.
Depois que um driver transferiu todos os dados e chamou FlushAdapterBuffers, ele chama FreeAdapterChannel para liberar o controlador DMA do sistema que foi alocado anteriormente com uma chamada para AllocateAdapterChannel.
FreeAdapterChannel libera todos os registros de mapa que foram alocados por uma chamada anterior para AllocateAdapterChannel. Um driver chama essa rotina somente se sua rotina AdapterControl retornar KeepObject.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| 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) |