Funzione WdfDmaTransactionGetBytesTransferred (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionGetBytesTransferred restituisce il numero totale di byte trasferiti per una transazione DMA specificata.
Sintassi
size_t WdfDmaTransactionGetBytesTransferred(
[in] WDFDMATRANSACTION DmaTransaction
);
Parametri
[in] DmaTransaction
Handle a un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.
Valore restituito
WdfDmaTransactionGetBytesTransferred restituisce il numero totale di byte trasferiti per la transazione DMA specificata dal parametro DmaTransaction .
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
I driver basati su framework chiamano in genere WdfDmaTransactionGetBytesTransferred dall'interno di una funzione di callback degli eventi EvtInterruptDpc , dopo il completamento di tutti i trasferimenti DMA, per ottenere il conteggio dei byte trasferiti finale. I driver usano in genere il conteggio di byte finale come input per il metodo WdfRequestCompleteWithInformation . Per altre informazioni su questo metodo, vedere Completamento di una transazione DMA.
Esempio
Per un esempio di codice che usa WdfDmaTransactionGetBytesTransferred, vedere WdfDmaTransactionDmaCompleted.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |