WdfDpcCancel 함수(wdfdpc.h)

[KMDF에만 적용]

WdfDpcCancel 메서드는 DPC 개체의 예약된 EvtDpcFunc 콜백 함수 실행을 취소하려고 시도합니다.

구문

BOOLEAN WdfDpcCancel(
  [in] WDFDPC  Dpc,
  [in] BOOLEAN Wait
);

매개 변수

[in] Dpc

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

[in] Wait

TRUE인 경우 DPC 개체의 EvtDpcFunc 콜백 함수가 취소되거나 실행을 완료할 때까지 WdfDpcCancel 메서드가 반환되지 않음을 나타내는 부울 값입니다. FALSE이면 WdfDpcCancel 메서드가 즉시 반환됩니다.

반환 값

지정된 DPC 개체의 EvtDpcFunc 콜백 함수가 시스템의 DPC 큐에 있는 경우 WdfDpcCancel은 TRUE를 반환합니다. 콜백 함수가 실행 중이거나 실행을 완료했기 때문에 콜백 함수가 DPC 큐에 없는 경우 메서드는 FALSE 를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

지정된 DPC 개체의 EvtDpcFunc 콜백 함수가 시스템의 DPC 큐에 있으면 큐에서 제거됩니다. EvtDpcFunc 함수가 큐에 없는 경우 실행 중이거나 실행을 완료했습니다.

Wait 매개 변수가 TRUE이면 IRQL = PASSIVE_LEVEL WdfDpcCancel을 호출해야 합니다. Wait 매개 변수가 FALSE이면 모든 IRQL에서 WdfDpcCancel을 호출할 수 있습니다.

예제

다음 코드 예제에서는 WdfDpcCreate 항목의 코드 예제에서 만든 DPC 개체와 연결된 콜백 함수의 실행을 취소합니다.

WdfDpcCancel(
             PDevExt->CompleteWriteDpc,
             TRUE
             );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfdpc.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	설명 섹션을 참조하십시오.
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

EvtDpcFunc