Функция 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.

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

Нет

Замечания

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

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

Требования

См. также

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute