EVT_WDF_INTERRUPT_WORKITEM 콜백 함수(wdfinterrupt.h)

[KMDF 및 UMDF에 적용]

드라이버의 EvtInterruptWorkItem 이벤트 콜백 함수는 드라이버의 EvtInterruptIsr 콜백 함수가 저장한 인터럽트 정보를 처리합니다.

구문

EVT_WDF_INTERRUPT_WORKITEM EvtWdfInterruptWorkitem;

void EvtWdfInterruptWorkitem(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFOBJECT AssociatedObject
)
{...}

매개 변수

[in] Interrupt

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

[in] AssociatedObject

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

반환 값

없음

설명

EvtInterruptWorkItem 콜백 함수는 IRQL = PASSIVE_LEVEL 실행됩니다.

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

대부분의 드라이버는 각 인터럽트 유형에 대해 단일 EvtInterruptWorkItem 콜백 함수를 사용합니다.

EvtInterruptWorkItem 콜백 함수의 실행을 예약하려면 드라이버는 EvtInterruptIsr 콜백 함수 내에서 WdfInterruptQueueWorkItemForIsr를 호출해야 합니다.

드라이버가 각 디바이스에 대해 여러 프레임워크 인터럽트 개체를 만드는 경우 각 인터럽트에 대해 별도의 EvtInterruptWorkItem 콜백을 사용하는 것이 좋습니다.

DIRQL 인터럽트 처리 또는 수동 수준 인터럽트 처리를 구현하는 드라이버는 EvtInterruptWorkItem 콜백을 큐에 대기할 수 있습니다.

드라이버는 EvtInterruptDpc 와 EvtInterruptWorkItem 콜백을 모두 큐에 대기할 수 없습니다.

드라이버가 인터럽트의 WDF_INTERRUPT_CONFIG 구조에서 AutomaticSerialization 멤버를 TRUE로 설정한 경우 프레임워크는 인터럽트 개체의 EvtInterruptWorkItem 콜백 함수 실행을 인터럽트의 부모 개체 아래에 있는 다른 개체의 콜백 함수와 동기화합니다. 콜백 동기화 잠금에 대한 자세한 내용은 프레임워크 잠금 사용을 참조하세요.

일반적으로 드라이버가 EvtInterruptWorkItem 내에서 인터럽트 개체의 수동 잠금을 획득해야 하는 경우 드라이버는 WDF_INTERRUPT_CONFIGAutomaticSerialization 멤버를 FALSE로 설정한 다음 EvtInterruptWorkItem 내에서 WdfInterruptAcquireLock을 호출해야 합니다.

AutomaticSerialization이 TRUE로 설정된 경우 드라이버의 EvtInterruptWorkItem 콜백 함수는 다음 메서드를 호출하지 않아야 합니다.

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

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.11
최소 UMDF 버전	2.0
머리글	wdfinterrupt.h(Wdf.h 포함)
IRQL	PASSIVE_LEVEL