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	설명 부분을 참조하십시오.

추가 정보

EvtDeviceD0ExitPreInterruptsDisabled

EvtInterruptEnable

WDF_INTERRUPT_CONFIG

WdfInterruptCreate

WdfInterruptDisable