Partager via


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)

Voir aussi

WdfDmaTransactionAllocateResources