Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[Solo se aplica a KMDF]
Se llama a la función de devolución de llamada de evento 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 recursos DMA.
[in] Context
Puntero de contexto que el controlador especificó en una llamada anterior a WdfDmaTransactionAllocateResources.
Valor devuelto
Ninguno
Observaciones
Los controladores registran una función de devolución de llamada de evento evtReserveDma llamando a WdfDmaTransactionAllocateResources.
El marco llama a la EvtReserveDma de un controlador función de devolución de llamada de eventos cuando se han asignado recursos DMA para 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 inicia la transacción desde su EvtReserveDma función de devolución de llamada de eventos. Para obtener más información sobre la secuencia de reservas, 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, también se puede usar EvtReserveDma con un habilitador que especifica un habilitador DMA en modo sistema.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.11 |
| encabezado | wdfdmatransaction.h (incluya Wdf.h) |
| irQL | DISPATCH_LEVEL |