EVT_WDF_RESERVE_DMA función de devolución de llamada (wdfdmatransaction.h)

[Solo se aplica a KMDF]

Se llama a la función de devolución de llamada de eventos EvtReserveDma cuando el marco tiene recursos reservados para ejecutar y liberar una transacción. Los recursos reservados incluyen registros de mapa y el bloqueo del adaptador de WDM DMA.

Sintaxis

EVT_WDF_RESERVE_DMA EvtWdfReserveDma;

void EvtWdfReserveDma(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] PVOID Context
)
{...}

Parámetros

[in] DmaTransaction

Identificador del objeto de transacción DMA que representa la transacción a la que se asignaron los recursos DMA.

[in] Context

Puntero de contexto que el controlador especificó en una llamada anterior a WdfDmaTransactionAllocateResources.

Valor devuelto

None

Observaciones

Los controladores registran una función de devolución de llamada de evento EvtReserveDma llamando a WdfDmaTransactionAllocateResources.

El marco llama a la función de devolución de llamada de eventos EvtReserveDma de un controlador cuando se han asignado recursos DMA para su uso exclusivo con el objeto de transacción asociado. El controlador puede inicializar y ejecutar la transacción varias veces mientras mantiene esta reserva.

Normalmente, un controlador inicializa y, a continuación, inicia la transacción desde su función de devolución de llamada de eventos EvtReserveDma . Para obtener más información sobre la secuencia de reserva, consulte Reserva de recursos de DMA.

El controlador puede llamar a WdfDmaTransactionFreeResources desde EvtReserveDma.

En sistemas operativos anteriores a Windows 8, EvtReserveDma debe usarse con un habilitador que especifique un habilitador DMA en modo de paquete. A partir de Windows 8, EvtReserveDma también se puede usar con un habilitador que especifica un habilitador DMA en modo sistema.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.11
Encabezado	wdfdmatransaction.h (incluya Wdf.h)
IRQL	DISPATCH_LEVEL

Consulte también

WdfDmaTransactionAllocateResources

WdfDmaTransactionFreeResources