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)

Vedi anche

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation