Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die EvtReserveDma Ereignisrückruffunktion wird aufgerufen, wenn das Framework Ressourcen zum Ausführen und Freigeben einer Transaktion reserviert hat. Reservierte Ressourcen umfassen Kartenregister und die Sperre des WDM-DMA-Adapters.
Syntax
EVT_WDF_RESERVE_DMA EvtWdfReserveDma;
void EvtWdfReserveDma(
[in] WDFDMATRANSACTION DmaTransaction,
[in] PVOID Context
)
{...}
Die Parameter
[in] DmaTransaction
Ein Handle für das DMA-Transaktionsobjekt, das die Transaktion darstellt, der DMA-Ressourcen zugewiesen wurden.
[in] Context
Der Kontextzeiger, den der Treiber in einem vorherigen Aufruf von WdfDmaTransactionAllocateResourcesangegeben hat.
Rückgabewert
Nichts
Bemerkungen
Treiber registrieren eine EvtReserveDma Ereignisrückruffunktion durch Aufrufen WdfDmaTransactionAllocateResources.
Das Framework ruft die EvtReserveDma Ereignisrückruffunktion eines Treibers auf, wenn DMA-Ressourcen für die exklusive Verwendung mit dem zugeordneten Transaktionsobjekt zugewiesen wurden. Der Treiber kann die Transaktion mehrmals initialisieren und ausführen, während diese Reservierung gehalten wird.
Ein Treiber initialisiert die Transaktion in der Regel und initiiert dann die Transaktion innerhalb der EvtReserveDma Ereignisrückruffunktion. Weitere Informationen zur Reservierungssequenz finden Sie unter Reserving DMA Resources.
Der Treiber kann WdfDmaTransactionFreeResources innerhalb EvtReserveDmaaufrufen.
Unter Betriebssystemen vor Windows 8 muss EvtReserveDma mit einem Enabler verwendet werden, der einen Paketmodus-DMA-Enabler angibt. Ab Windows 8 können EvtReserveDma- auch mit einem Enabler verwendet werden, der einen DMA-Enabler im Systemmodus angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.11 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| IRQL | DISPATCH_LEVEL |