EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED 콜백 함수(wdfdevice.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtDeviceD0ExitPreInterruptsDisabled 이벤트 콜백 함수는 드라이버가 디바이스의 하드웨어 인터럽트를 사용하지 않도록 설정하기 전에 필요한 디바이스별 작업을 수행합니다.
통사론
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;
NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
[in] WDFDEVICE Device,
[in] WDF_POWER_DEVICE_STATE TargetState
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] TargetState
디바이스가 입력하려고 하는 디바이스 전원 상태를 식별하는 WDF_POWER_DEVICE_STATE형식의 열거자입니다.
반환 값
EvtDeviceD0ExitPreInterruptsDisabled 콜백 함수에 오류가 발생하지 않으면 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 TRUE 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 false 상태 값을 반환해야 합니다.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류참조하세요.
발언
EvtDeviceD0ExitPreInterruptsDisabled 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks를 호출해야 합니다.
프레임워크가 드라이버의 EvtInterruptDisable 콜백 함수를 호출하기 전에 EvtDeviceD0ExitPreInterruptsDisabled 콜백 함수는 IRQL = PASSIVE_LEVEL 호출됩니다. EvtInterruptDisable 콜백 함수의 IRQL = DIRQL에서 작업을 수행하지 않아야 하는 경우 드라이버는 인터럽트를 사용하지 않도록 설정하기 전에 디바이스별 작업을 수행해야 하는 경우 이 함수를 제공할 수 있습니다.
프레임워크가 이 콜백 함수를 호출하는 시기에 대한 자세한 내용은 PnP 및 Power Management 시나리오참조하세요.
인터럽트 처리에 대한 자세한 내용은 하드웨어 인터럽트 처리참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 헤더 | wdfdevice.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL(설명 섹션 참조) |