Compartir a través de

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 evento 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 EvtDmaTransactionConfigureDmaChannel función de devolución de llamada de eventos o NULL para borrarlo.

[in, optional] ConfigureContext

Puntero a un búfer que contiene el contexto que se va a proporcionar al EvtDmaTransactionConfigureDmaChannel función de devolución de llamada de eventos o NULL.

Valor devuelto

Ninguno

Observaciones

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

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

  1. Llama a WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitializeo WdfDmaTransactionInitializeUsingOffset para inicializar el objeto de transacción.
  2. Llama a WdfDmaTransactionSetChannelConfigurationCallback en el objeto de transacción.
  3. Llama a WdfDmaTransactionExecute.
Si el controlador ha especificado una función de devolución de llamada 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 Valor
cliente mínimo admitido Windows 8
de la plataforma de destino de Universal
versión mínima de KMDF 1.11
encabezado wdfdmatransaction.h (incluya Wdf.h)
Biblioteca 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