Freigeben über


WdfDmaTransactionGetBytesTransferred-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionGetBytesTransferred-Methode gibt die Gesamtanzahl der Bytes zurück, die für eine angegebene DMA-Transaktion übertragen wurden.

Syntax

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreate abgerufen hat.

Rückgabewert

WdfDmaTransactionGetBytesTransferred gibt die Gesamtzahl der Bytes zurück, die für die DMA-Transaktion übertragen wurden, die vom DmaTransaction-Parameter angegeben wurde.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Frameworkbasierte Treiber rufen in der Regel WdfDmaTransactionGetBytesTransferred aus einer EvtInterruptDpc-Ereignisrückruffunktion auf, nachdem alle DMA-Übertragungen abgeschlossen sind, um die endgültige übertragene Byteanzahl zu erhalten. Treiber verwenden in der Regel die letzte Byteanzahl als Eingabe für die WdfRequestCompleteWithInformation-Methode . Weitere Informationen zu dieser Methode finden Sie unter Abschließen einer DMA-Transaktion.

Beispiele

Ein Codebeispiel, das WdfDmaTransactionGetBytesTransferred verwendet, finden Sie unter WdfDmaTransactionDmaCompleted.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdmatransaction.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation