Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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
);
Die Parameter
[in] DmaTransaction
Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreateabgerufen hat.
Rückgabewert
WdfDmaTransactionGetBytesTransferred gibt die Gesamtanzahl der Bytes zurück, die für die DMA-Transaktion übertragen wurden, die der DmaTransaction-parameter angegeben.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Frameworkbasierte Treiber rufen in der Regel WdfDmaTransactionGetBytesTransferred innerhalb eines EvtInterruptDpc Ereignisrückruffunktion auf, nachdem alle DMA-Übertragungen abgeschlossen sind, um die endgültige übertragene Byteanzahl abzurufen. 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 WdfDmaTransactionGetBytesTransferredverwendet, finden Sie unter WdfDmaTransactionDmaCompleted.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |