Función WdfDmaTransactionGetBytesTransferred (wdfdmatransaction.h)
[Solo se aplica a KMDF]
El método WdfDmaTransactionGetBytesTransferred devuelve el número total de bytes transferidos para una transacción DMA especificada.
Sintaxis
size_t WdfDmaTransactionGetBytesTransferred(
[in] WDFDMATRANSACTION DmaTransaction
);
Parámetros
[in] DmaTransaction
Identificador de un objeto de transacción DMA que el controlador obtuvo de una llamada anterior a WdfDmaTransactionCreate.
Valor devuelto
WdfDmaTransactionGetBytesTransferred devuelve el número total de bytes transferidos para la transacción DMA que especificó el parámetro DmaTransaction.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
Normalmente, los controladores basados en marcos llaman a WdfDmaTransactionGetBytesTransferred desde un EvtInterruptDpc función de devolución de llamada de eventos, una vez completadas todas las transferencias DMA, para obtener el recuento final de bytes transferidos. Los controladores suelen usar el número de bytes final como entrada para el método WdfRequestCompleteWithInformation. Para obtener más información sobre este método, vea Completar una transacción DMA.
Ejemplos
Para obtener un ejemplo de código que usa WdfDmaTransactionGetBytesTransferred, vea WdfDmaTransactionDmaCompleted.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfdmatransaction.h (incluya Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| irQL | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |