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) |