Compartilhar via


Função WdfDmaTransactionFreeResources (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionFreeResources libera recursos de DMA que o driver alocou anteriormente chamando WdfDmaTransactionAllocateResources.

Sintaxe

void WdfDmaTransactionFreeResources(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parâmetros

[in] DmaTransaction

Um identificador para o objeto de transação DMA que o driver forneceu em uma chamada anterior para WdfDmaTransactionAllocateResources.

Valor de retorno

Nenhum

Observações

WdfDmaTransactionFreeResources deve ser usado com um habilitador de DMA que especifica um perfil de sistema ou pacote.

Em sistemas operacionais anteriores ao Windows 8, WdfDmaTransactionFreeResources deve ser usado com um habilitador que especifica um habilitador de DMA de pacote único. A partir do Windows 8, WdfDmaTransactionFreeResources também pode ser usado com um habilitador que especifica um habilitador de DMA no modo sistema.

Quando chamado com um habilitador de DMA de dispersão/coleta, WdfDmaTransactionFreeResources causa uma verificação de bug do verificador.

A chamada do driver para WdfDmaTransactionFreeResources pode fazer com que a estrutura chame EvtProgramDma ou EvtReserveDma imediatamente.

Para obter mais informações sobre o DMA no modo de sistema, consulte Suporte System-Modede DMA.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.11
cabeçalho wdfdmatransaction.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <=DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf)

Consulte também

WdfDmaTransactionAllocateResources