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.

Comentarios

Normalmente, los controladores basados en marcos llaman a WdfDmaTransactionGetBytesTransferred desde dentro de una función de devolución de llamada de eventos EvtInterruptDpc , una vez completadas todas las transferencias DMA, para obtener el recuento de bytes transferidos final. Normalmente, los controladores usan el recuento de bytes final como entrada para el método WdfRequestCompleteWithInformation . Para obtener más información sobre este método, consulte Finalización de una transacción DMA.

Ejemplos

Para obtener un ejemplo de código que usa WdfDmaTransactionGetBytesTransferred, vea WdfDmaTransactionDmaCompleted.

Requisitos

Consulte también

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation