EVT_WDF_INTERRUPT_DPC 콜백 함수(wdfinterrupt.h)

  • 아티클

[KMDF 및 UMDF에 적용]

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

구문

EVT_WDF_INTERRUPT_DPC EvtWdfInterruptDpc;

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

매개 변수

[in] Interrupt

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

[in] AssociatedObject

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

반환 값

없음

설명

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

드라이버는 일반적으로 EvtInterruptDpc 콜백 함수에서 I/O 요청을 완료합니다.

EvtInterruptDpc 콜백 함수는 DISPATCH_LEVEL 실행되며 페이징 가능한 코드에 액세스해서는 안 됩니다. EvtInterruptDpc 콜백 함수가 IRQL = PASSIVE_LEVEL 작업을 수행해야 하는 경우 프레임워크 작업 항목을 사용할 수 있습니다.

KMDF 버전 1.11 이상에서 드라이버는 수동 수준 인터럽 트를 지원하고 EvtInterruptWorkItem 또는 EvtInterruptDpc 콜백 함수를 제공할 수 있습니다. 드라이버가 수동 수준 인터럽트를 지원하고 EvtInterruptDpc 콜백 함수를 제공하는 경우 드라이버는 콜백 내에서 수동 수준 인터럽트 잠금을 획득할 수 없습니다.

대부분의 드라이버는 각 인터럽트 유형에 대해 단일 EvtInterruptDpc 콜백 함수를 사용합니다. 드라이버가 각 디바이스에 대해 여러 프레임워크 큐 개체 를 만드는 경우 각 큐에 대해 별도의 DPC 개체 및 EvtDpcFunc 콜백 함수를 사용하는 것이 좋습니다.

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

드라이버가 EvtInterruptDpc 콜백 함수의 실행을 예약하면 시스템에서 DPC 개체를 시스템의 DPC 큐에 추가합니다. 시스템이 우선 순위가 높은 작업을 실행하지 않는 경우 큐에서 개체를 제거하고 EvtInterruptDpc 콜백 함수를 호출합니다.

개체가 이미 큐에 있는 경우 시스템에서 DPC 개체를 DPC 큐에 추가하지 않습니다. 시스템이 EvtInterruptDpc 콜백 함수를 호출하기 전에 EvtInterruptIsr 콜백 함수를 여러 번 호출할 수 있습니다. 따라서 EvtInterruptDpc 콜백 함수는 여러 인터럽트에서 정보를 처리할 수 있어야 하며 마지막으로 호출된 이후 발생한 모든 인터럽트를 처리해야 합니다.

일반적으로 드라이버의 EvtInterruptDpc 콜백 함수 실행을 다른 콜백 함수의 실행과 동기화해야 합니다. 자세한 내용은 인터럽트 코드 동기화를 참조하세요.

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

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfinterrupt.h(Wdf.h 포함)
IRQL 설명 부분을 참조하십시오.

추가 정보

EvtDpcFunc

EvtInterruptIsr

WDF_INTERRUPT_CONFIG

WdfInterruptCreate

WdfInterruptQueueDpcForIsr