Функция WdfDmaTransactionGetBytesTransferred (wdfdmatransaction.h)

[Применимо только к KMDF]

Метод WdfDmaTransactionGetBytesTransferred возвращает общее количество байтов, передаваемых для указанной транзакции DMA.

Синтаксис

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

Параметры

[in] DmaTransaction

Дескриптор объекта транзакции DMA, полученный драйвером из предыдущего вызова WdfDmaTransactionCreate.

Возвращаемое значение

WdfDmaTransactionGetBytesTransferred возвращает общее количество байтов, переданных для транзакции DMA, указанной параметром DMA DmaTransaction.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Драйверы на основе платформы обычно вызывают WdfDmaTransactionGetBytesTransferred из EvtInterruptDpc функцию обратного вызова событий, после завершения передачи DMA, чтобы получить окончательное число переданных байтов. Драйверы обычно используют окончательное число байтов в качестве входных данных для метода WdfRequestCompleteWithInformation. Дополнительные сведения об этом методе см. в разделе Завершениетранзакции DMA.

Примеры

Пример кода, использующий WdfDmaTransactionGetBytesTransferred, см. в разделе WdfDmaTransactionDmaCompleted.

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
Заголовок	wdfdmatransaction.h (include Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation