Compartilhar via


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

A rotina PutDmaAdapter libera uma estrutura de DMA_ADAPTER alocada anteriormente por IoGetDmaAdapter.

Sintaxe

PPUT_DMA_ADAPTER PputDmaAdapter;

void PputDmaAdapter(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parâmetros

[in] DmaAdapter

Ponteiro para a estrutura DMA_ADAPTER a ser liberada.

Valor de retorno

Nenhum

Observações

PutDmaAdapter 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.

PutDmaAdapter libera um objeto do adaptador DMA alocado anteriormente por IoGetDmaAdapter. Os drivers devem chamar PutDmaAdapter depois de concluir as operações de DMA e liberar todos os registros de mapa e buffer comum alocados com esse objeto do adaptador. Depois que PutDmaAdapter retorna, o driver não pode mais usar o objeto do adaptador DMA.

Um driver deve chamar PutDmaAdapter quando receber uma solicitação de IRP_MN_STOP_DEVICE PnP.

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

Consulte também

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter