Função WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionWdmGetTransferContext recupera o contexto de transferência do WDM associado a uma transação de 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.

Retornar valor

Um ponteiro para o contexto de transferência de DMA (PTRANSFER_CONTEXT) associado à transação.

Comentários

O contexto de transferência de DMA para uma transação é alocado quando o driver cria a transação.

WdfDmaTransactionWdmGetTransferContext deve ser usado com um habilitador de DMA que usa o DMA versão 3. Para selecionar a versão 3, defina o membro WdmDmaVersionOverride de WDF_DMA_ENABLER_CONFIG como 3.

O driver pode usar o contexto de transferência de DMA para chamar as seguintes rotinas de biblioteca de DMA do WDM diretamente:

Você deve inicializar a transação DMA antes de chamar WdfDmaTransactionWdmGetTransferContext.

Requisitos

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

Confira também

WdfDmaTransactionCreate