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

  • Статья

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

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

Синтаксис

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

Параметры

[in] DmaTransaction

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

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

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

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

Комментарии

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

Примеры

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdmatransaction.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation