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(status)가 false 경우 프레임워크는 드라이버의 EvtDeviceSelfManagedIoFlush 호출하고 콜백 함수를 EvtDeviceSelfManagedIoCleanup을.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류참조하세요.
발언
EvtDeviceSelfManagedIoSuspend 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks호출해야 합니다.
드라이버가 콜백 함수를 EvtDeviceSelfManagedIoSuspend를 등록한 경우 프레임워크는 다음 이유 중 하나로 호출합니다.
- 디바이스가 저전력 상태로 들어가려고 합니다.
- 디바이스가 제거되거나 깜짝 제거되었습니다.
- 플러그 앤 플레이 관리자는 시스템의 연결된 디바이스 간에 시스템의 하드웨어 리소스를 재배포하려고 합니다.
디바이스가 저전력 상태로 들어가려고 하는 경우 프레임워크는 드라이버의 EvtDeviceD0Exit 콜백 함수를 호출하기 전에 드라이버의 EvtDeviceSelfManagedIoSuspend 콜백 함수를 호출합니다.
콜백 함수가 NT_SUCCESS(상태)가 FALSE같은 상태 값을 반환하고 프레임워크가 디바이스의 전원을 낮추려고 하면 프레임워크가 디바이스를 중지하고 해당 디바이스 개체를 제거합니다.
EvtDeviceSelfManagedIoSuspend 콜백 함수는 디바이스의 자체 관리형 I/O 작업을 중지하는 데 필요한 모든 작업을 수행해야 합니다.
프레임워크가 이 콜백 함수를 호출하는 시기에 대한 자세한 내용은 PnP 및 Power Management 시나리오참조하세요.
이 콜백 함수를 제공하는 드라이버에 대한 자세한 내용은 using Self-Managed I/O참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 헤더 | wdfdevice.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL |