EVT_WDF_RESERVE_DMA funzione di callback (wdfdmatransaction.h)
[Si applica solo a KMDF]
La funzione di callback dell'evento EvtReserveDma viene chiamata quando il framework dispone di risorse riservate per l'esecuzione e il rilascio di una transazione. Le risorse riservate includono registri mappa e blocco dell'adattatore DMA WDM.
Sintassi
EVT_WDF_RESERVE_DMA EvtWdfReserveDma;
void EvtWdfReserveDma(
[in] WDFDMATRANSACTION DmaTransaction,
[in] PVOID Context
)
{...}
Parametri
[in] DmaTransaction
Handle per l'oggetto transazione DMA che rappresenta la transazione a cui sono state assegnate le risorse DMA.
[in] Context
Puntatore di contesto specificato dal driver in una chiamata precedente a WdfDmaTransactionAllocateResources.
Valore restituito
nessuno
Osservazioni
I driver registrano una funzione di callback degli eventi EvtReserveDma chiamando WdfDmaTransactionAllocateResources.
Il framework chiama la funzione di callback dell'evento EvtReserveDma di un driver quando le risorse DMA sono state assegnate per l'uso esclusivo con l'oggetto transazione associato. Il driver può inizializzare ed eseguire la transazione più volte mantenendo questa prenotazione.
Un driver in genere inizializza e quindi avvia la transazione dall'interno della relativa funzione di callback dell'evento EvtReserveDma . Per altre informazioni sulla sequenza di prenotazione, vedere Prenotazione di risorse DMA.
Il driver può chiamare WdfDmaTransactionFreeResources dall'interno di EvtReserveDma.
Nei sistemi operativi precedenti a Windows 8, EvtReserveDma deve essere usato con un abilitatore che specifica un abilitatore DMA in modalità pacchetto. A partire da Windows 8, EvtReserveDma può essere usato anche con un abilitatore che specifica un abilitatore DMA in modalità sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.11 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| IRQL | DISPATCH_LEVEL |