Função WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionGetTransferInfo retorna o número de registros de mapa e entradas de lista de dispersão/coleta necessárias para uma transação DMA inicializada.

Sintaxe

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

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA inicializado.

[out, optional] MapRegisterCount

Um local fornecido pelo chamador que, no retorno, contém o número de registros de mapa necessários para a transação especificada. Esse parâmetro é opcional e pode ser NULL.

[out, optional] ScatterGatherElementCount

Um local fornecido pelo chamador que, no retorno, contém o número de elementos de dispersão/coleta necessários para a transação especificada. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

Nenhum

Observações

O driver pode chamar WdfDmaTransactionGetTransferInfo antes de chamar WdfDmaTransactionAllocateResources ou WdfDmaTransactionExecute.

Ao usar o DMA versão 3, esse método retorna uma contagem precisa do número de registros de mapa necessários. Ao usar versões anteriores do DMA, esse método pressupõe que cada página requer um registro de mapa.

Requisitos

Consulte também

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute