EVT_WDF_DMA_ENABLER_SELFMANAGED_IO_START回呼函式 (wdfdmaenabler.h)

  • 發行項

[僅適用於 KMDF]

驅動程式的 EvtDmaEnablerSelfManagedIoStart 事件回呼函式會啟動 DMA 裝置的自我管理 I/O 作業。

語法

EVT_WDF_DMA_ENABLER_SELFMANAGED_IO_START EvtWdfDmaEnablerSelfmanagedIoStart;

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

參數

[in] DmaEnabler

DMA 啟用表達式物件的句柄。

傳回值

EvtDmaEnablerSelfManagedIoStart 必須傳回STATUS_SUCCESS或另一個狀態值， NT_SUCCESS (狀態) 等於 TRUE，如果發生任何錯誤。 否則，這個回呼函式必須傳回狀態值，NT_SUCCESS (狀態) 等於 FALSE。

備註

若要註冊 EvtDmaEnablerSelfManagedIoStart 回呼函式，DMA 裝置的函式驅動程式會在驅動程式呼叫 WdfDmaEnablerCreate 之前，將回呼函式的位址放在WDF_DMA_ENABLER_CONFIG結構中。

如需 EvtDmaEnablerSelfManagedIoStart 回呼函式的詳細資訊，請參閱 支援 DMA 裝置的電源管理。

EvtDmaEnablerSelfManagedIoStart 回呼函式會在 IRQL = PASSIVE_LEVEL呼叫。 您不應該讓此回呼函 式可分頁。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfdmaenabler.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL (请参阅一节)

另請參閱

EvtDmaEnablerSelfManagedIoStop

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate