WdfDmaTransactionFreeResources, fonction (wdfdmatransaction.h)
[S’applique à KMDF uniquement]
La méthode WdfDmaTransactionFreeResources libère les ressources DMA que le pilote a précédemment allouées en appelant WdfDmaTransactionAllocateResources.
Syntaxe
void WdfDmaTransactionFreeResources(
[in] WDFDMATRANSACTION DmaTransaction
);
Paramètres
[in] DmaTransaction
Handle de l’objet de transaction DMA fourni par le pilote lors d’un appel précédent à WdfDmaTransactionAllocateResources.
Valeur de retour
None
Remarques
WdfDmaTransactionFreeResources doit être utilisé avec un enabler DMA qui spécifie un paquet ou un profil système.
Sur les systèmes d’exploitation antérieurs à Windows 8, WdfDmaTransactionFreeResources doit être utilisé avec un enabler qui spécifie un enabler DMA à paquet unique. À compter de Windows 8, WdfDmaTransactionFreeResources peut également être utilisé avec un enabler qui spécifie un enabler DMA en mode système.
Lorsqu’il est appelé avec un enabler DMA de nuages de points/regroupements, WdfDmaTransactionFreeResources provoque un bogue de vérificateur case activée.
L’appel du pilote à WdfDmaTransactionFreeResources peut amener le framework à appeler Immédiatement EvtProgramDma ou EvtReserveDma .
Pour plus d’informations sur l’assistant DMA en mode système, consultez Prise en charge System-Mode DMA.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.11 |
| En-tête | wdfdmatransaction.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf) |