EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT 콜백 함수(wdfdevice.h)

아티클
02/07/2025

[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 경우 프레임워크는 드라이버의 EvtDeviceSelfManagedIoFlush 호출하고 콜백 함수를 EvtDeviceSelfManagedIoCleanup을.

이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류참조하세요.

발언

EvtDeviceSelfManagedIoInit 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks호출해야 합니다.

드라이버가 EvtDeviceSelfManagedIoInit 콜백 함수를 등록한 경우 프레임워크가 드라이버의 EvtDeviceD0Entry 콜백 함수를 처음 호출한 후 각 디바이스에 대해 한 번 호출합니다. 디바이스가 제거되고 다시 연결되거나 드라이버가 다시 로드되지 않는 한 프레임워크는 해당 디바이스에 대해 EvtDeviceSelfManagedIoInit 콜백 함수를 다시 호출하지 않습니다.

EvtDeviceSelfManagedIoInit 콜백 함수는 드라이버가 디바이스에 대해 처리할 자체 관리형 I/O 작업을 초기화하고 시작해야 합니다.

프레임워크가 이 콜백 함수를 호출하는 시기에 대한 자세한 내용은 PnP 및 Power Management 시나리오참조하세요.

이 콜백 함수를 제공하는 드라이버에 대한 자세한 내용은 using Self-Managed I/O참조하세요.