Función WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDmaTransactionSetChannelConfigurationCallback registra una función de devolución de llamada de eventos de configuración de canal para una transacción DMA en modo sistema.

Sintaxis

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

Parámetros

[in] DmaTransaction

Identificador de un objeto de transacción DMA inicializado para el que se va a establecer o borrar la devolución de llamada de configuración del canal.

[in, optional] ConfigureRoutine

Puntero a la función de devolución de llamada de eventos EvtDmaTransactionConfigureDmaChannel del controlador o NULL para borrarlo.

[in, optional] ConfigureContext

Puntero a un búfer que contiene el contexto que se va a proporcionar a la función de devolución de llamada de eventos EvtDmaTransactionConfigureDmaChannel del controlador.

Valor devuelto

None

Observaciones

Este método permite al controlador personalizar la configuración del adaptador antes de programar el controlador DMA del sistema.

Normalmente, desde dentro de una función de devolución de llamada de eventos de cola de E/S, un controlador realiza los pasos siguientes, en este orden:

  1. Llama a WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize o WdfDmaTransactionInitializeUsingOffset para inicializar el objeto de transacción.
  2. Llama a WdfDmaTransactionSetChannelConfigurationCallback en el objeto transaction.
  3. Llama a WdfDmaTransactionExecute.
Si el controlador ha especificado una función de devolución de llamada de eventos EvtDmaTransactionConfigureDmaChannel llamando a WdfDmaTransactionSetChannelConfigurationCallback y el controlador llama posteriormente a WdfDmaTransactionRelease, se borra la devolución de llamada.

WdfDmaTransactionSetChannelConfigurationCallback debe usarse con un habilitador DMA que especifique un perfil DMA en modo sistema.

Si el controlador llama a este método en un sistema operativo anterior a Windows 8, el comprobador del marco notifica un error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Plataforma de destino Universal
Versión mínima de KMDF 1.11
Encabezado wdfdmatransaction.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf)

Consulte también

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease