다음을 통해 공유


WdfDpcEnqueue 함수(wdfdpc.h)

[KMDF에만 적용]

WdfDpcEnqueue 메서드는 DPC 개체의 EvtDpcFunc 콜백 함수의 실행을 예약합니다.

구문론

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

매개 변수

[in] Dpc

프레임워크 DPC 개체에 대한 핸들입니다.

반환 값

WdfDpcEnqueue 지정된 DPC 개체를 시스템의 DPC 큐에 성공적으로 추가하면 TRUE 반환합니다. 그렇지 않으면 메서드는 false 반환합니다.

드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.

비고

WdfDpcEnqueue 메서드는 지정된 DPC 개체를 시스템의 DPC 큐에 추가합니다(아직 큐에 없는 경우). (DPC 개체가 큐에 이미 있는 경우 메서드는 false 반환합니다.) 시스템에서 우선 순위가 높은 작업을 실행하지 않으면 큐에서 DPC 개체를 제거하고 개체의 EvtDpcFunc 콜백 함수를 호출합니다.

콜백 함수가 실행되면 WdfDpcEnqueue 대한 후속 호출은 DPC 개체를 DPC 큐에 다시 추가합니다.

DPC 개체 사용에 대한 자세한 내용은 인터럽트 서비스참조하세요.

예시

다음 코드 예제에서는 DPC 개체와 연결된 콜백 함수의 실행을 예약합니다. 이 예제에서는 WdfDpcEnqueue 메서드의 반환 값을 포함하는 함수의 반환 값으로 사용합니다. WdfDpcCreate 코드 예제에서는 DPC 개체를 만든 방법을 보여 집니다.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

요구 사항

요구 사항 가치
대상 플랫폼 보편적
최소 KMDF 버전 1.0
헤더 wdfdpc.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL 모든 수준
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

참고하십시오

EvtDpcFunc

WdfDpcCreate