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)

Consulte también

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation