WdfDmaTransactionFreeResources-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionFreeResources Methode gibt DMA-Ressourcen frei, die der Treiber zuvor zugeordnet hat, indem WdfDmaTransactionAllocateResourcesaufgerufen wird.
Syntax
void WdfDmaTransactionFreeResources(
[in] WDFDMATRANSACTION DmaTransaction
);
Die Parameter
[in] DmaTransaction
Ein Handle für das DMA-Transaktionsobjekt, das der Treiber in einem vorherigen Aufruf von WdfDmaTransactionAllocateResourcesbereitgestellt hat.
Rückgabewert
Nichts
Bemerkungen
WdfDmaTransactionFreeResources- muss mit einem DMA-Enabler verwendet werden, der ein Paket- oder Systemprofil angibt.
Unter Betriebssystemen vor Windows 8 muss WdfDmaTransactionFreeResources- mit einem Enabler verwendet werden, der einen DMA-Enabler mit einem Paket angibt. Ab Windows 8 können WdfDmaTransactionFreeResources auch mit einem Enabler verwendet werden, der einen DMA-Enabler im Systemmodus angibt.
Wenn WdfDmaTransactionFreeResources mit einem Punkt/Gather-DMA-Enabler aufgerufen wird, führt zu einer Prüffehlerüberprüfung.
Der Aufruf des Treibers an WdfDmaTransactionFreeResources kann dazu führen, dass das Framework sofort EvtProgramDma oder EvtReserveDma aufruft.
Weitere Informationen zum Systemmodus-DMA finden Sie unter Unterstützen von System-Mode DMA-.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.11 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |