Função WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)
[Aplica-se somente ao KMDF]
O método WdfDmaTransactionWdmGetTransferContext recupera o contexto de transferência do WDM associado a uma transação DMA.
Sintaxe
PVOID WdfDmaTransactionWdmGetTransferContext(
[in] WDFDMATRANSACTION DmaTransaction
);
Parâmetros
[in] DmaTransaction
Um identificador para um objeto de transação DMA inicializado do qual recuperar o contexto de transferência.
Valor de retorno
Um ponteiro para o contexto de transferência de DMA (PTRANSFER_CONTEXT) associado à transação.
Observações
O contexto de transferência de DMA para uma transação é alocado quando o driver cria a transação.
WdfDmaTransactionWdmGetTransferContext deve ser usada com um habilitador de DMA que usa o DMA versão 3. Para selecionar a versão 3, defina o WdmDmaVersionOverride membro do WDF_DMA_ENABLER_CONFIG como 3.
O driver pode usar o contexto de transferência de DMA para chamar diretamente as seguintes rotinas de biblioteca de DMA do WDM:
- AllocateAdapterChannelEx
- CancelAdapterChannel
- CancelMappedTransfer
- GetScatterGatherListEx
- BuildScatterGatherListEx