Функция 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 этот метод предполагает, что для каждой страницы требуется регистр карты.

Требования

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

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute