EVT_WDF_INTERRUPT_DISABLE 콜백 함수(wdfinterrupt.h)

2025-03-22

[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 이벤트 콜백 함수를 호출합니다.

프레임워크 기반 드라이버에서 인터럽트 처리에 대한 자세한 내용은 하드웨어 인터럽트 처리참조하세요.