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 per 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.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni:
I driver basati su framework chiamano in genere WdfDmaTransactionGetBytesTransferred da un EvtInterruptDpc funzione di callback degli eventi, dopo il completamento di tutti i trasferimenti DMA, per ottenere il conteggio dei byte trasferiti finale. I driver usano in genere il conteggio dei byte finale come input per il metodo WdfRequestCompleteWithInformation. Per altre informazioni su questo metodo, vedere Completamento di una transazione DMA.
Esempi
Per un esempio di codice che usa WdfDmaTransactionGetBytesTransferred, vedere WdfDmaTransactionDmaCompleted.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfdmatransaction.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |