WdfDmaTransactionGetTransferInfo-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionGetTransferInfo Methode gibt die Anzahl der Kartenregister und Punkt-/Sammellisteneinträ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
);

Die Parameter

[in] DmaTransaction

Ein Handle für ein initialisiertes DMA-Transaktionsobjekt.

[out, optional] MapRegisterCount

Ein vom Aufrufer bereitgestellter Standort, der im Gegenzug 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 im Gegenzug die Anzahl der Punkt/Gather-Elemente enthält, die für die angegebene Transaktion erforderlich sind. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Nichts

Bemerkungen

Der Treiber ruft möglicherweise WdfDmaTransactionGetTransferInfo auf, bevor WdfDmaTransactionAllocateResources oder WdfDmaTransactionExecuteaufgerufen wird.

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

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)

Siehe auch

WdfDmaTransactionAllocateResources-

WdfDmaTransactionExecute