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

  • Статья

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

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

Синтаксис

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

Параметры

[in] DmaTransaction

Дескриптор инициализированного объекта транзакции DMA.

[out, optional] MapRegisterCount

Указанное вызывающим объектом расположение, которое при возврате содержит количество регистров карты, необходимых для указанной транзакции. Этот параметр является необязательным и может иметь значение NULL.

[out, optional] ScatterGatherElementCount

Указанное вызывающей стороной расположение, которое при возврате содержит количество элементов точечной и сборной, необходимых для указанной транзакции. Этот параметр является необязательным и может иметь значение NULL.

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

None

Remarks

Драйвер может вызывать WdfDmaTransactionGetTransferInfo перед вызовом WdfDmaTransactionAllocateResources или WdfDmaTransactionExecute.

При использовании DMA версии 3 этот метод возвращает точное количество регистров карты. При использовании более ранних версий DMA этот метод предполагает, что для каждой страницы требуется регистр карты.

Требования

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

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

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute