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 메서드가 즉시 반환됩니다.

반환 값

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

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

비고

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

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

예시

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

WdfDpcCancel(
             PDevExt->CompleteWriteDpc,
             TRUE
             );

요구 사항

참고하십시오

EvtDpcFunc