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 |