EVT_WDF_DMA_ENABLER_FLUSH Rückruffunktion (wdfdmaenabler.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die EvtDmaEnablerFlush-Ereignisrückruffunktion eines Treibers löst die Zuordnung der DMA-Puffer eines Geräts.

Syntax

EVT_WDF_DMA_ENABLER_FLUSH EvtWdfDmaEnablerFlush;

NTSTATUS EvtWdfDmaEnablerFlush(
  [in] WDFDMAENABLER DmaEnabler
)
{...}

Parameter

[in] DmaEnabler

Ein Handle für ein DMA-Aktivierungsobjekt.

Rückgabewert

EvtDmaEnablerFlush muss STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) true entspricht, wenn keine Fehler auftreten. Andernfalls muss diese Rückruffunktion einen status Wert zurückgeben, für den NT_SUCCESS(status) false entspricht.

Hinweise

Um eine EvtDmaEnablerFlush-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 EvtDmaEnablerFlush finden Sie unter Unterstützung der Energieverwaltung für DMA-Geräte.