WdfDmaTransactionFreeResources-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionFreeResources-Methode gibt DMA-Ressourcen frei, die der Treiber zuvor durch Aufrufen von WdfDmaTransactionAllocateResources zugeordnet hat.
Syntax
void WdfDmaTransactionFreeResources(
[in] WDFDMATRANSACTION DmaTransaction
);
Parameter
[in] DmaTransaction
Ein Handle für das DMA-Transaktionsobjekt, das der Treiber in einem vorherigen Aufruf von WdfDmaTransactionAllocateResources bereitgestellt hat.
Rückgabewert
Keine
Bemerkungen
WdfDmaTransactionFreeResources muss mit einem DMA-Enabler verwendet werden, der ein Paket- oder Systemprofil angibt.
Auf Betriebssystemen vor Windows 8 muss WdfDmaTransactionFreeResources mit einem Enabler verwendet werden, der eine DMA-Aktivierung für einzelne Pakete angibt. Ab Windows 8 kann WdfDmaTransactionFreeResources auch mit einem Enabler verwendet werden, der eine DMA-Aktivierung im Systemmodus angibt.
Wenn WdfDmaTransactionFreeResources mit einem Scatter/Gather-DMA-Enabler aufgerufen wird, wird eine Überprüfung des Prüfers verursacht.
Der Aufruf des Treibers an WdfDmaTransactionFreeResources kann dazu führen, dass das Framework EvtProgramDma oder EvtReserveDma sofort aufruft .
Weitere Informationen zu DMA im Systemmodus finden Sie unter Unterstützen System-Mode DMA.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.11 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |