EVT_WDF_INTERRUPT_DISABLE 콜백 함수(wdfinterrupt.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtInterruptDisable 이벤트 콜백 함수는 지정된 하드웨어 인터럽트를 사용하지 않도록 설정합니다.
구문
EVT_WDF_INTERRUPT_DISABLE EvtWdfInterruptDisable;
NTSTATUS EvtWdfInterruptDisable(
[in] WDFINTERRUPT Interrupt,
[in] WDFDEVICE AssociatedDevice
)
{...}
매개 변수
[in] Interrupt
프레임워크 인터럽트 개체에 대한 핸들입니다.
[in] AssociatedDevice
드라이버가 WdfInterruptCreate에 전달한 프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
EvtInterruptDisable 콜백 함수는 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 오류가 발생하지 않는 경우 TRUE와 같은 다른 상태 값을 반환해야 합니다. 그렇지 않으면 이 함수는 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다.
설명
EvtInterruptDisable 콜백 함수를 등록하려면 드라이버가 WdfInterruptCreate를 호출하기 전에 콜백 함수의 주소를 WDF_INTERRUPT_CONFIG 구조에 배치해야 합니다.
프레임워크는 디바이스가 작동(D0) 상태를 떠날 때마다 드라이버의 EvtInterruptDisable 콜백 함수를 호출합니다. 또한 드라이버는 WdfInterruptDisable을 호출하여 프레임워크가 EvtInterruptDisable 콜백 함수를 호출하도록 할 수 있습니다. 프레임워크는 디바이스가 작동(D0) 상태를 떠날 때마다 드라이버의 EvtInterruptDisable 콜백 함수를 호출하므로 대부분의 프레임워크 기반 드라이버는 WdfInterruptDisable을 호출해서는 안 됩니다.
EvtInterruptDisable 콜백 함수를 호출하기 전에 프레임워크는 프로세서의 IRQL을 디바이스의 DIRQL로 올리고 드라이버가 인터럽트 개체의 WDF_INTERRUPT_CONFIG 구조에 지정한 스핀 잠금을 획득합니다.
KMDF 버전 1.11부터 드라이버는 수동 수준 인터럽트 처리를 제공할 수 있습니다. 드라이버가 수동 수준 인터럽트 처리를 요청한 경우 IRQL = PASSIVE_LEVEL EvtInterruptDisable 함수를 호출하기 전에 프레임워크는 드라이버가 인터럽트 개체의 WDF_INTERRUPT_CONFIG 구조에 구성된 수동 수준 인터럽트 잠금을 획득합니다.
EvtInterruptDisable 콜백 함수를 호출하기 전에 프레임워크는 IRQL = PASSIVE_LEVEL 드라이버의 EvtDeviceD0ExitPreInterruptsDisabled 이벤트 콜백 함수를 호출합니다.
프레임워크 기반 드라이버에서 인터럽트 처리에 대한 자세한 내용은 하드웨어 인터럽트 처리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfinterrupt.h(Wdf.h 포함) |
| IRQL | 설명 부분을 참조하십시오. |