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 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) |