IWDFIoRequest2::IsCanceled 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

IsCanceled 메서드는 I/O 관리자가 I/O 요청을 취소하려고 했는지 여부를 결정합니다.

구문

BOOL IsCanceled();

반환 값

I/O 관리자가 I/O 요청을 취소하려고 하면 IsCanceled는 TRUE를 반환합니다. 이 메서드는 다음과 같은 이유로 FALSE 를 반환합니다.

  • I/O 관리자가 요청을 취소하려고 시도하지 않았습니다.
  • 호출 드라이버는 요청을 소유하지 않습니다.
  • 호출 드라이버가 IWDFIoRequest::MarkCancelable 메서드를 호출했습니다.

설명

드라이버가 IRequestCallbackCancel::OnCancel 콜백 함수를 등록하기 위해 IWDFIoRequest::MarkCancelable을 호출하지 않았지만 드라이버가 I/O 관리자가 I/O 요청을 취소하려고 했는지 확인하려는 경우 드라이버는 IsCanceled를 호출할 수 있습니다.

드라이버는 드라이버가 I/O 요청을 소유하는 경우에만 요청에 대해 IsCanceled 를 호출할 수 있습니다. 드라이버가 IWDFIoRequest::MarkCancelable을 호출한 경우 IsCanceled를 호출하기 전에 IWDFIoRequest::UnmarkCancelable을 호출해야 합니다.

IsCanceled가TRUE를 반환하는 경우 드라이버는 CompletionStatus 매개 변수가 HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED)로 설정된 IWDFIoRequest::Complete를 호출하여 요청을 취소해야 합니다.

IsCanceled에 대한 자세한 내용은 I/O 요청 취소를 참조하세요.

예제

다음 코드 예제에서 IsCanceled가 TRUE를 반환하는 경우 드라이버는 IWDFIoRequest::Complete를 호출하여 I/O 요청을 완료하고 HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED)의 완료 상태.

if (fxRequest2->IsCanceled())
{
    fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.9
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable