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

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfdmatransaction.h (incluya Wdf.h)
Library	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