Função WdfDmaTransactionFreeResources (wdfdmatransaction.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionFreeResources libera recursos de DMA que o driver alocava 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.

Retornar valor

Nenhum

Comentários

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

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

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

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-Mode DMA.

Requisitos

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

Confira também

WdfDmaTransactionAllocateResources