WdfDmaTransactionDmaCompletedFinal-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionDmaCompletedFinal-Methode benachrichtigt das Framework darüber, dass der DMA-Übertragungsvorgang eines Geräts mit einer Unterlaufbedingung abgeschlossen wurde, und gibt die Länge der abgeschlossenen Übertragung an.
Syntax
BOOLEAN WdfDmaTransactionDmaCompletedFinal(
[in] WDFDMATRANSACTION DmaTransaction,
[in] size_t FinalTransferredLength,
[out] NTSTATUS *Status
);
Parameter
[in] DmaTransaction
Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreate abgerufen hat.
[in] FinalTransferredLength
Die Anzahl der Bytes, die das Gerät übertragen hat.
[out] Status
Ein Zeiger auf eine Position, die die status der DMA-Übertragung empfängt. Weitere Informationen finden Sie im Abschnitt Hinweise zu WdfDmaTransactionDmaCompleted.
Rückgabewert
WdfDmaTransactionDmaCompletedFinal gibt FALSE zurück, wenn der Treiber einen ungültigen Eingabeparameter bereitstellt. Andernfalls gibt WdfDmaTransactionDmaCompletedFinal immer TRUE zurück, was angibt, dass das Framework nicht versucht, weitere Bytes für die DMA-Transaktion zu übertragen, die der DmaTransaction-Parameter angegeben hat.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Ein Treiber ruft in der Regel WdfDmaTransactionDmaCompletedFinal innerhalb seines EvtInterruptDpc-Rückrufs auf. Ein Treiber für ein DMA-Gerät im Systemmodus kann WdfDmaTransactionDmaCompletedFinal innerhalb einer EvtDmaTransactionDmaTransferComplete-Ereignisrückruffunktion aufrufen.
Im PLX9x5x-Beispiel ruft der Treiber WdfDmaTransactionDmaCompletedFinal über seine Rückruffunktion EvtProgramDma auf.
Die WdfDmaTransactionDmaCompletedFinal-Methode verhält sich wie WdfDmaTransactionDmaCompleted, mit der Ausnahme, dass Treiber in der Regel WdfDmaTransactionDmaCompletedFinal aufrufen, wenn die Hardware eine Unterlaufbedingung meldet. Eine Unterlaufbedingung bedeutet, dass die Hardware nicht alle Bytes übertragen konnte, die für die letzte DMA-Übertragung angegeben wurden. Ein Aufruf von WdfDmaTransactionDmaCompletedFinal verhindert, dass das Framework weitere DMA-Übertragungen für die angegebene DMA-Transaktion startet.
Wenn Ihr Treiber WdfDmaTransactionDmaCompletedFinal aufruft, gibt der Treiber die Anzahl der übertragenen Bytes an. Der Rückgabewert ist immer TRUE, da das Framework nicht versucht, weitere Bytes für die angegebene Transaktion zu übertragen.
Weitere Informationen zum Abschließen von DMA-Übertragungen finden Sie unter Abschließen einer DMA-Übertragung.
Beispiele
Im folgenden Codebeispiel wird das Framework darüber benachrichtigt, dass der DMA-Übertragungsvorgang eines Geräts mit einer Unterlaufbedingung abgeschlossen wurde.
BOOLEAN success;
NTSTATUS status;
success = WdfDmaTransactionDmaCompletedFinal(
DmaTransaction,
transferLength,
&status
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdmatransaction.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |