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

Confira também

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer