EVT_WDF_DMA_ENABLER_ENABLE Rückruffunktion (wdfdmaenabler.h)
[Gilt nur für KMDF]
Die EvtDmaEnablerEnable-Ereignisrückruffunktion eines Treibers aktiviert die DMA-Funktion eines Geräts, nachdem das Gerät in den Betriebszustand (D0) wechselt.
Syntax
EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;
NTSTATUS EvtWdfDmaEnablerEnable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parameter
[in] DmaEnabler
Ein Handle für ein DMA-Enabler-Objekt.
Rückgabewert
EvtDmaEnablerEnable 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 EvtDmaEnablerEnable-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 EvtDmaEnablerEnable finden Sie unter Unterstützung der Energieverwaltung für DMA-Geräte.
Die Rückruffunktion EvtDmaEnablerEnable 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") |