EVT_WDF_DMA_ENABLER_ENABLE回呼函式 (wdfdmaenabler.h)
[僅適用於 KMDF]
驅動程式的 EvtDmaEnablerEnable 事件回呼函式會在裝置進入其工作狀態 (D0) 狀態之後啟用裝置的 DMA 功能。
語法
EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;
NTSTATUS EvtWdfDmaEnablerEnable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
參數
[in] DmaEnabler
DMA enabler 物件的句柄。
返回值
EvtDmaEnablerEnable 必須傳回STATUS_SUCCESS或另一個狀態值,NT_SUCCESS狀態)等於 TRUE,如果它沒有發生任何錯誤。 否則,這個回呼函式必須傳回狀態值,NT_SUCCESS狀態) 等於 FALSE。
備註
若要註冊 EvtDmaEnablerEnable 回呼函式,DMA 裝置的函式驅動程式會在驅動程式呼叫 WdfDmaEnablerCreate之前,將回呼函式的位址放在 WDF_DMA_ENABLER_CONFIG 結構中。
如需有關 EvtDmaEnablerEnable 回呼函式的詳細資訊,請參閱 支援 DMA 裝置的電源管理。
EvtDmaEnablerEnable 回呼函式會在 IRQL = PASSIVE_LEVEL呼叫。 您不應該讓此回呼函式 可分頁。
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標題 | wdfdmaenabler.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL (請參閱一節) |