[KMDF에만 적용]
드라이버의 EvtDpcFunc 콜백 함수는 IRQL = DISPATCH_LEVEL 드라이버 정의 작업을 수행합니다.
구문론
EVT_WDF_DPC EvtWdfDpc;
VOID EvtWdfDpc(
[in] WDFDPC Dpc
)
{...}
매개 변수
[in] Dpc
프레임워크 DPC 개체에 대한 핸들입니다.
반환 값
없음
비고
EvtDpcFunc 콜백 함수를 등록하려면 드라이버가 함수의 주소를 WDF_DPC_CONFIG 구조에 배치하고 WdfDpcCreate 호출해야 합니다.
드라이버는 일반적으로 EvtDpcFunc 콜백 함수에서 I/O 요청을 완료할 있습니다.
EvtDpcFunc 콜백 함수는 DISPATCH_LEVEL 실행되며 페이징 가능한 코드에 액세스해서는 안 됩니다. EvtDpcFunc 콜백 함수가 IRQL = PASSIVE_LEVEL 작업을 수행해야 하는 경우 프레임워크 작업 항목을 사용할있습니다.
EvtDpcFunc 콜백 함수를 제공하는 대신, 많은 드라이버는 디바이스가 지원하는 각 유형의 인터럽트에 대해 단일 EvtInterruptDpc 콜백 함수를 제공합니다. 드라이버가 각 디바이스에 대해 여러 프레임워크 큐 개체를 만드는 경우 각 큐에 대해 별도의 DPC 개체 및 EvtDpcFunc 콜백 함수를 사용하는 것이 좋습니다.
EvtDpcFunc 콜백 함수의 실행을 예약하려면 드라이버가 WdfDpcEnqueue호출해야 합니다. 드라이버는 일반적으로 EvtInterruptIsr 콜백 함수에서 WdfDpcEnqueue 호출합니다.
드라이버가 WdfDpcEnqueue 호출하면 시스템에서 DPC 개체를 시스템의 DPC 큐에 추가합니다. 시스템에서 우선 순위가 높은 작업을 실행하지 않으면 큐에서 개체를 제거하고 개체의 EvtDpcFunc 콜백 함수를 호출합니다.
개체가 이미 큐에 있는 경우 시스템에서 DPC 개체를 DPC 큐에 추가하지 않습니다. EvtInterruptIsr 콜백 함수는 시스템에서 EvtDpcFunc 콜백 함수를 호출하기 전에 여러 번 호출될 수 있습니다. 따라서 EvtDpcFunc 콜백 함수는 여러 인터럽트의 정보를 처리할 수 있어야 하며 마지막으로 호출된 이후 발생한 모든 인터럽트를 처리해야 합니다.
일반적으로 드라이버의 EvtDpcFunc 콜백 함수의 실행을 다른 콜백 함수의 실행과 동기화해야 합니다. 자세한 내용은 인터럽트 코드 동기화 참조하세요.
DPC 개체의 부모 개체에 대한 핸들을 가져오기 위해 EvtDpcFunc 콜백 함수는 WdfDpcGetParentObject 호출할 수 있습니다. DPC 개체의 기본 KDPC 구조에 대한 포인터를 가져오기 위해 EvtDpcFunc 콜백 함수는 WdfDpcWdmGetDpc호출할 수 있습니다.
EvtDpcFunc 콜백 함수를 사용하는 방법에 대한 자세한 내용은 인터럽트 서비스참조하세요.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfdpc.h(Wdf.h 포함) |
| IRQL | DISPATCH_LEVEL |