EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART 콜백 함수(wdfdevice.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtDeviceSelfManagedIoRestart 이벤트 콜백 함수는 디바이스의 자체 관리형 I/O 작업을 다시 시작합니다.
구문
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
EvtDeviceSelfManagedIoRestart 콜백 함수에 오류가 발생하지 않으면 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다. NT_SUCCESS(상태)이 FALSE인 경우 프레임워크는 디바이스를 중지하고 디바이스의 드라이버를 언로드합니다.
NT_SUCCESS(상태)가 FALSE인 경우 프레임워크는 드라이버의 EvtDeviceSelfManagedIoFlush 및 EvtDeviceSelfManagedIoCleanup 콜백 함수를 호출합니다.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류를 참조하세요.
설명
EvtDeviceSelfManagedIoRestart 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks를 호출해야 합니다.
드라이버가 EvtDeviceSelfManagedIoRestart 콜백 함수를 등록한 경우 프레임워크는 디바이스가 저전력 상태에서 작동(D0) 상태로 반환될 때마다 호출합니다. 프레임워크는 드라이버의 EvtDeviceSelfManagedIoSuspend 콜백 함수를 호출한 후에만 EvtDeviceSelfManagedIoRestart 콜백 함수를 호출합니다.
드라이버의 EvtDeviceSelfManagedIoRestart 콜백 함수는 디바이스의 자체 관리형 I/O 작업을 다시 시작하는 데 필요한 모든 작업을 수행해야 합니다.
프레임워크가 이 콜백 함수를 호출하는 시기에 대한 자세한 내용은 PnP 및 전원 관리 시나리오를 참조하세요.
이 콜백 함수를 제공하는 드라이버에 대한 자세한 내용은 Self-Managed I/O 사용을 참조하세요.
EvtDeviceSelfManagedIoRestart 콜백 함수는 IRQL = PASSIVE_LEVEL 호출됩니다. 이 콜백 함수를 페이지할 수 있도록 해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfdevice.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL(설명 섹션 참조) |