EVT_WDF_DMA_ENABLER_FILL Rückruffunktion (wdfdmaenabler.h)
[Gilt nur für KMDF]
Die EvtDmaEnablerFill-Ereignisrückruffunktion eines Treibers ordnet die DMA-Puffer eines Geräts zu.
Syntax
EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;
NTSTATUS EvtWdfDmaEnablerFill(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parameter
[in] DmaEnabler
Ein Handle für ein DMA-Enabler-Objekt.
Rückgabewert
EvtDmaEnablerFill muss STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist, wenn keine Fehler auftreten. Andernfalls muss diese Rückruffunktion einen status Wert zurückgeben, für den NT_SUCCESS(status) gleich FALSE ist.
Hinweise
Um eine EvtDmaEnablerFill-Rückruffunktion zu registrieren, platziert ein Funktionstreiber für ein DMA-Gerät die Adresse der Rückruffunktion in einer WDF_DMA_ENABLER_CONFIG-Struktur , bevor der Treiber WdfDmaEnablerCreate aufruft.
Weitere Informationen zur Rückruffunktion EvtDmaEnablerFill finden Sie unter Unterstützung der Energieverwaltung für DMA-Geräte.
Die Rückruffunktion EvtDmaEnablerFill wird unter IRQL = PASSIVE_LEVEL aufgerufen. Sie sollten diese Rückruffunktion nicht auslagerungsfähig machen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdmaenabler.h (einschließen von Wdf.h) |
| IRQL | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |