EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND 콜백 함수(wdfdevice.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtDeviceSelfManagedIoSuspend 이벤트 콜백 함수는 디바이스의 자체 관리형 I/O 작업을 일시 중단합니다.
구문
EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND EvtWdfDeviceSelfManagedIoSuspend;
NTSTATUS EvtWdfDeviceSelfManagedIoSuspend(
[in] WDFDEVICE Device
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
작업이 성공하면 EvtDeviceSelfManagedIoSuspend 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)이 FALSE와 같은 상태 값을 반환해야 합니다. NT_SUCCESS(상태)이 FALSE와 같으면 프레임워크는 디바이스를 중지하고 해당 디바이스 개체를 제거합니다.
NT_SUCCESS(상태)이 FALSE인 경우 프레임워크는 드라이버의 EvtDeviceSelfManagedIoFlush 및 EvtDeviceSelfManagedIoCleanup 콜백 함수를 호출합니다.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류를 참조하세요.
설명
EvtDeviceSelfManagedIoSuspend 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks를 호출해야 합니다.
드라이버가 EvtDeviceSelfManagedIoSuspend 콜백 함수를 등록한 경우 프레임워크는 다음 이유 중 하나로 호출합니다.
- 디바이스가 저전력 상태로 들어가려고 합니다.
- 디바이스가 제거되었거나 깜짝 제거되었습니다.
- 플러그 앤 플레이 관리자는 시스템의 연결된 디바이스 간에 시스템의 하드웨어 리소스를 재배포하려고 합니다.
디바이스가 저전력 상태로 들어가려는 경우 프레임워크는 드라이버의 EvtDeviceD0Exit 콜백 함수를 호출하기 전에 드라이버의 EvtDeviceSelfManagedIoSuspend 콜백 함수를 호출합니다.
콜백 함수가 NT_SUCCESS(상태)이 FALSE와 같은 상태 값을 반환하고 프레임워크가 디바이스의 전원을 낮추려고 하면 프레임워크가 디바이스를 중지하고 해당 디바이스 개체를 제거합니다.
EvtDeviceSelfManagedIoSuspend 콜백 함수는 디바이스의 자체 관리형 I/O 작업을 중지하는 데 필요한 모든 작업을 수행해야 합니다.
프레임워크가 이 콜백 함수를 호출하는 경우에 대한 자세한 내용은 PnP 및 전원 관리 시나리오를 참조하세요.
이 콜백 함수를 제공하는 드라이버에 대한 자세한 내용은 Self-Managed I/O 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfdevice.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL |