Função WdfDmaTransactionFreeResources (wdfdmatransaction.h)
[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) |