Compartilhar via

Função WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionSetChannelConfigurationCallback registra uma função de retorno de chamada de evento de configuração de canal para uma transação DMA no modo sistema.

Sintaxe

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA inicializado para o qual definir ou limpar o retorno de chamada de configuração de canal.

[in, optional] ConfigureRoutine

Um ponteiro para o do driver EvtDmaTransactionConfigureDmaChannel função de retorno de chamada de evento ou NULL para desmarcá-la.

[in, optional] ConfigureContext

Um ponteiro para um buffer que contém o contexto a ser fornecido para o do driver EvtDmaTransactionConfigureDmaChannel função de retorno de chamada de evento ou NULL.

Valor de retorno

Nenhum

Observações

Esse método permite que o driver personalize a configuração do adaptador antes de programar o controlador DMA do sistema.

Normalmente, de dentro de uma função de retorno de chamada de evento de fila de E/S , um driver executa as seguintes etapas, nesta ordem:

  1. Chama WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitializeou WdfDmaTransactionInitializeUsingOffset para inicializar o objeto de transação.
  2. Chama WdfDmaTransactionSetChannelConfigurationCallback no objeto de transação.
  3. Chamadas WdfDmaTransactionExecute .
Se o driver tiver especificado uma função de retorno de chamada de evento EvtDmaTransactionConfigureDmaChannel chamando WdfDmaTransactionSetChannelConfigurationCallback e o driver posteriormente chamará WdfDmaTransactionRelease, o retorno de chamada será desmarcado.

WdfDmaTransactionSetChannelConfigurationCallback deve ser usado com um habilitador de DMA que especifica um perfil DMA no modo sistema.

Se o driver chamar esse método em um sistema operacional anterior ao Windows 8, o verificador da estrutura relatará um erro.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8
da Plataforma de Destino Universal
versão mínima do KMDF 1.11
cabeçalho wdfdmatransaction.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <=DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf)

Consulte também

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease