EVT_WDF_INTERRUPT_SYNCHRONIZE 콜백 함수(wdfinterrupt.h)

  • 아티클

[KMDF 및 UMDF에 적용]

드라이버의 EvtInterruptSynchronize 이벤트 콜백 함수는 EvtInterruptIsr 콜백 함수와 동기화해야 하는 작업을 수행합니다.

구문

EVT_WDF_INTERRUPT_SYNCHRONIZE EvtWdfInterruptSynchronize;

BOOLEAN EvtWdfInterruptSynchronize(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFCONTEXT Context
)
{...}

매개 변수

[in] Interrupt

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

[in] Context

드라이버가 WdfInterruptSynchronize를 호출할 때 지정하는 드라이버 제공 정보입니다.

반환 값

작업이 성공하면 EvtInterruptSynchronize 콜백 함수가 TRUE 를 반환해야 합니다. 그렇지 않으면 이 함수는 FALSE를 반환해야 합니다.

설명

EvtInterruptSynchronize 콜백 함수를 실행하려면 드라이버가 WdfInterruptSynchronize를 호출해야 합니다.

드라이버가 디바이스의 IRQL(DIRQL)에서 처리하도록 인터럽트 개체를 구성한 경우 EvtInterruptSynchronize 콜백 함수를 호출하기 전에 프레임워크는 프로세서의 인터럽트 요청 수준을 DIRQL로 높이고 드라이버가 인터럽트 개체의 WDF_INTERRUPT_CONFIG 구조에 지정한 스핀 잠금을 획득합니다.

따라서 EvtInterruptSynchronize 콜백 함수가 실행되는 동안 인터럽트 개체의 EvtInterruptIsr 콜백 함수(및 스핀 잠금을 보유하는 동안 DIRQL에서 실행되는 다른 코드)는 실행할 수 없습니다.

EvtInterruptSynchronize 콜백 함수는 짧은 시간 동안만 실행되도록 설계되어야 합니다. 일반적으로 인터럽트 개체의 다른 EvtInterruptSynchronize 또는 EvtInterruptIsr 콜백 함수에서 액세스하는 인터럽트 데이터에 액세스하는 데 사용됩니다.

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

EvtInterruptSynchronize 콜백 함수에 대한 자세한 내용은 인터럽트 코드 동기화를 참조하세요.

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

요구 사항

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

추가 정보

EvtInterruptIsr

WDF_INTERRUPT_CONFIG

WdfInterruptSynchronize