PFREE_ADAPTER_CHANNEL função de retorno de chamada (wdm.h)

Artigo
02/29/2024

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)