Compartilhar via


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)

Consulte também

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer