WdfInterruptQueueWorkItemForIsr 함수(wdfinterrupt.h)

[KMDF 및 UMDF에 적용]

WdfInterruptQueueWorkItemForIsr 메서드는 실행을 위해 프레임워크 인터럽트 개체의 EvtInterruptWorkItem 콜백 함수를 큐에 대기합니다.

구문

BOOLEAN WdfInterruptQueueWorkItemForIsr(
  [in] WDFINTERRUPT Interrupt
);

매개 변수

[in] Interrupt

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

반환 값

드라이버의 ISR이 IRQL = PASSIVE_LEVEL 실행 중인 경우 WdfInterruptQueueWorkItemForIsr는 인터럽트 개체의 EvtInterruptWorkItem 콜백 함수를 성공적으로 큐에 대기하면 TRUE를 반환합니다. 콜백 함수가 이전에 큐에 대기하고 실행되지 않은 경우 메서드는 FALSE 를 반환합니다.

드라이버의 ISR이 IRQL = DIRQL에서 실행되는 경우 프레임워크는 먼저 내부 DPC를 큐에 넣은 다음 해당 DPC에서 작업 항목을 큐에 대기합니다. 이 경우 프레임워크가 내부 DPC를 성공적으로 큐에 대기하는 경우 WdfInterruptQueueWorkItemForIsr 는 TRUE 를 반환합니다. 내부 DPC가 이전에 큐에 대기된 경우 메서드는 FALSE 를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

드라이버는 일반적으로 EvtInterruptIsr 콜백 함수 내에서 WdfInterruptQueueWorkItemForIsr를 호출합니다.

인터럽트 개체의 EvtInterruptWorkItem 콜백 함수는 실행되기 전에 한 번만 큐에 대기할 수 있습니다. 따라서 WdfInterruptQueueWorkItemForIsr에 대한 호출이 성공하면 후속 호출은 추가 콜백을 큐에 추가하지 않습니다.

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

드라이버가 EvtInterruptWorkItem 콜백 함수를 지정하지 않는 인터럽트 개체를 사용하여 WdfInterruptQueueWorkItemForIsr을 호출하는 경우 버그 검사 발생합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.11
최소 UMDF 버전	2.0
머리글	wdfinterrupt.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<=DIRQL
DDI 규정 준수 규칙	DriverCreate(kmdf)

추가 정보

EvtInterruptDpc

EvtInterruptIsr

WdfInterruptCreate

WdfInterruptQueueDpcForIsr