Função WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

  • Artigo

[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 de DMA no modo de 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 a função de retorno de chamada de evento EvtDmaTransactionConfigureDmaChannel do driver ou NULL para limpá-la.

[in, optional] ConfigureContext

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

Retornar valor

Nenhum

Comentários

Esse método permite que o driver personalize a configuração do adaptador antes de programar o controlador de 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, WdfDmaTransactionInitialize ou WdfDmaTransactionInitializeUsingOffset para inicializar o objeto de transação.
  2. Chama WdfDmaTransactionSetChannelConfigurationCallback no objeto de transação.
  3. Chama WdfDmaTransactionExecute.
Se o driver tiver especificado uma função de retorno de chamada de evento EvtDmaTransactionConfigureDmaChannel chamando WdfDmaTransactionSetChannelConfigurationCallback e o driver chamar WdfDmaTransactionRelease posteriormente, o retorno de chamada será limpo.

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

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

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

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease