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 DMA_ADAPTER retornada por IoGetDmaAdapter que representa o adaptador de master de barramento ou o controlador de DMA.
Retornar valor
Nenhum
Comentários
FreeAdapterChannel não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina pode ser chamada somente 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 chamará essa rotina somente se sua rotina AdapterControl retornar KeepObject.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| 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) |