共用方式為


EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT回呼函式 (wdfdevice.h)

[適用於 KMDF 和 UMDF]

驅動程式的 EvtDeviceSelfManagedIoInit 事件回呼函式會初始化並啟動裝置的自我管理 I/O 作業。

語法

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

NTSTATUS EvtWdfDeviceSelfManagedIoInit(
  [in] WDFDEVICE Device
)
{...}

參數

[in] Device

架構裝置物件的句柄。

傳回值

如果 EvtDeviceSelfManagedIoInit 回呼函式沒有發生任何錯誤,它必須傳回STATUS_SUCCESS,或 NT_SUCCESS狀態) 等於 TRUE的狀態值。 否則,它必須傳回狀態值,NT_SUCCESS狀態)等於 FALSE。 如果NT_SUCCESS(狀態) 等於 FALSE,則架構不會啟動裝置。

如果 NT_SUCCESS(status) 等於 false ,則架構會呼叫驅動程式的 EvtDeviceSelfManagedIoFlushEvtDeviceSelfManagedIoCleanup 回呼函式。

如需此回呼函式傳回值的詳細資訊,請參閱 報告裝置失敗

言論

若要註冊 EvtDeviceSelfManagedIoInit 回呼函式,驅動程式必須呼叫 WdfDeviceInitSetPnpPowerEventCallbacks

如果驅動程式已註冊 EvtDeviceSelfManagedIoInit 回呼函式,則架構會在架構第一次呼叫驅動程式的 EvtDeviceD0Entry 回呼函式之後,針對每個裝置呼叫它一次。 架構不會針對該裝置再次呼叫 EvtDeviceSelfManagedIoInit 回呼函式,除非移除並重新連線裝置,或重載驅動程式。

EvtDeviceSelfManagedIoInit 回呼函式必須初始化並啟動驅動程式將處理裝置的自我管理 I/O 作業。

如需架構呼叫此回呼函式時的詳細資訊,請參閱 PnP 和 Power Management Scenarios

如需提供此回呼函式之驅動程式的詳細資訊,請參閱使用 Self-Managed I/O

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfdevice.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend