WdfDmaTransactionGetTransferInfo-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionGetTransferInfo-Methode gibt die Anzahl der Kartenregister und Punkt-/Gather-Listeneinträge zurück, die für eine initialisierte DMA-Transaktion erforderlich sind.

Syntax

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

Parameter

[in] DmaTransaction

Ein Handle für ein initialisiertes DMA-Transaktionsobjekt.

[out, optional] MapRegisterCount

Ein vom Aufrufer bereitgestellter Speicherort, der bei der Rückgabe die Anzahl der Kartenregister enthält, die für die angegebene Transaktion erforderlich sind. Dieser Parameter ist optional und kann NULL sein.

[out, optional] ScatterGatherElementCount

Ein vom Aufrufer bereitgestellter Speicherort, der bei der Rückgabe die Anzahl der scatter/gather-Elemente enthält, die für die angegebene Transaktion erforderlich sind. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann WdfDmaTransactionGetTransferInfo aufrufen, bevor WdfDmaTransactionAllocateResources oder WdfDmaTransactionExecute aufgerufen wird.

Bei Verwendung der DMA-Version 3 gibt diese Methode eine genaue Anzahl der erforderlichen Kartenregister zurück. Bei Verwendung früherer DMA-Versionen wird bei dieser Methode davon ausgegangen, dass für jede Seite ein Zuordnungsregister erforderlich ist.

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

WdfDmaTransactionExecute