Freigeben über


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)

Weitere Informationen

WdfDmaTransactionAllocateResources