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")

Weitere Informationen

EvtDmaEnablerDisable

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerErstellen