WdfDpcEnqueue 함수(wdfdpc.h)

  • 아티클

[KMDF에만 적용]

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

구문

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

매개 변수

[in] Dpc

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

반환 값

지정된 DPC 개체를 시스템의 DPC 큐에 성공적으로 추가하면 WdfDpcEnqueue는 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