EVT_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL função de retorno de chamada (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDmaTransactionConfigureDmaChannel de um driver configura o adaptador DMA para um habilitador de DMA no modo de sistema.

Sintaxe

EVT_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL EvtWdfDmaTransactionConfigureDmaChannel;

BOOLEAN EvtWdfDmaTransactionConfigureDmaChannel(
  [in]           WDFDMATRANSACTION DmaTransaction,
  [in]           WDFDEVICE Device,
  [in]           PVOID Context,
  [in, optional] PMDL Mdl,
  [in]           size_t Offset,
  [in]           size_t Length
)
{...}

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA que representa a transação que está sendo executada.

[in] Device

Um identificador para o objeto de dispositivo de estrutura que o driver especificou quando chamou WdfDmaTransactionCreate.

[in] Context

O ponteiro de contexto especificado pelo driver em uma chamada anterior para WdfDmaTransactionSetChannelConfigurationCallback.

[in, optional] Mdl

Um ponteiro para uma única lista de descritores de memória (MDL) ou cadeia MDL que descreve o buffer associado à transferência atual ou NULL se a última transferência tiver sido concluída e o adaptador estiver sendo liberado.

[in] Offset

Um deslocamento de bytes para o buffer especificado no parâmetro Mdl em que a transferência atual é iniciada.

[in] Length

O número de bytes que estão sendo transferidos na transferência atual.

Retornar valor

A função de retorno de chamada EvtDmaTransactionConfigureDmaChannel retornará TRUE se configurar com êxito o canal DMA. Se essa função de retorno de chamada retornar FALSE, a estrutura interromperá a transação e não chamará EvtProgramDma.

Comentários

Os drivers registram uma função de retorno de chamada de evento EvtDmaTransactionConfigureDmaChannel chamando WdfDmaTransactionSetChannelConfigurationCallback.

A estrutura chama EvtDmaTransactionConfigureDmaChannel uma vez para cada transferência de DMA de perfil de sistema na transação, depois de alocar o canal do adaptador, mas antes de mapear a transferência e chamar EvtProgramDma.

O driver pode usar o retorno de chamada EvtDmaTransactionConfigureDmaChannel para definir qualquer programação personalizada para o adaptador DMA antes de mapear uma transferência.

Se o driver apresentar um erro ao configurar o canal, ele poderá interromper a transferência de DMA chamando WdfDmaTransactionDmaCompletedFinal e, se necessário, concluindo a solicitação. Em seguida, o driver deve retornar FALSE dessa função de retorno de chamada.

Requisitos

Confira também

WdfDmaTransactionDmaCompletedFinal

WdfDmaTransactionSetChannelConfigurationCallback