EVT_WDF_INTERRUPT_ENABLE 콜백 함수(wdfinterrupt.h)

[KMDF 및 UMDF에 적용]

드라이버의 EvtInterruptEnable 이벤트 콜백 함수는 지정된 하드웨어 인터럽트를 사용하도록 설정합니다.

구문

EVT_WDF_INTERRUPT_ENABLE EvtWdfInterruptEnable;

NTSTATUS EvtWdfInterruptEnable(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFDEVICE AssociatedDevice
)
{...}

매개 변수

[in] Interrupt

프레임워크 인터럽트 개체에 대한 핸들입니다.

[in] AssociatedDevice

드라이버가 WdfInterruptCreate에 전달한 프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

EvtInterruptEnable 콜백 함수는 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 오류가 발생하지 않는 경우 TRUE와 같은 다른 상태 값을 반환해야 합니다. 그렇지 않으면 이 함수는 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다.

설명

EvtInterruptEnable 콜백 함수를 등록하려면 드라이버가 WdfInterruptCreate를 호출하기 전에 콜백 함수의 주소를 WDF_INTERRUPT_CONFIG 구조에 배치해야 합니다.

프레임워크는 디바이스가 작동(D0) 상태가 될 때마다 드라이버의 EvtInterruptEnable 콜백 함수를 호출합니다. 또한 드라이버는 WdfInterruptEnable을 호출하여 프레임워크가 EvtInterruptEnable 콜백 함수를 호출하도록 할 수 있습니다. 프레임워크는 디바이스가 작동(D0) 상태가 될 때마다 드라이버의 EvtInterruptEnable 콜백 함수를 호출하므로 대부분의 프레임워크 기반 드라이버는 WdfInterruptEnable을 호출해서는 안 됩니다.

EvtInterruptEnable 콜백 함수를 호출하기 전에 프레임워크는 프로세서의 IRQL을 디바이스의 DIRQL로 올리고 드라이버가 인터럽트 개체의 WDF_INTERRUPT_CONFIG 구조에 지정한 스핀 잠금을 획득합니다.

KMDF 버전 1.11부터 드라이버는 수동 수준 인터럽트 처리를 제공할 수 있습니다. 드라이버가 수동 수준 인터럽트 처리를 요청한 경우 IRQL = PASSIVE_LEVEL EvtInterruptEnable 함수를 호출하기 전에 프레임워크는 드라이버가 인터럽트 개체의 WDF_INTERRUPT_CONFIG 구조에 구성된 수동 수준 인터럽트 잠금을 획득합니다.

EvtInterruptEnable 콜백 함수가 반환되면 프레임워크는 IRQL = PASSIVE_LEVEL 드라이버의 EvtDeviceD0EntryPostInterruptsEnabled 이벤트 콜백 함수를 호출합니다.

프레임워크가 드라이버의 EvtInterruptEnable 콜백 함수를 호출할 때마다 디바이스가 동일한 인터럽트 리소스를 사용한다고 가정해서는 안 됩니다. 경우에 따라 PnP 관리자는 시스템 리소스를 재배포하고 디바이스에 새 인터럽트 리소스를 할당할 수 있습니다. 드라이버는 WdfInterruptGetInfo 를 호출하여 디바이스의 인터럽트 리소스를 확인할 수 있습니다.

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

요구 사항

추가 정보

EvtDeviceD0EntryPostInterruptsEnabled

EvtInterruptDisable

WDF_INTERRUPT_CONFIG

WdfInterruptCreate

WdfInterruptEnable

WdfInterruptGetInfo