Função WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

  • Artigo

[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 de 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.

Retornar valor

Nenhum

Comentários

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

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.11
Cabeçalho wdfdmatransaction.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf)

Confira também

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute