IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue 메서드(wudfddi.h)

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

드라이버의 OnIoCanceledOnQueue 이벤트 콜백 함수는 I/O 큐에 있는 동안 I/O 요청이 취소되었음을 드라이버에 알릴 수 있습니다.

구문

void OnIoCanceledOnQueue(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest
);

매개 변수

[in] pWdfQueue

I/O 요청이 취소되었을 때 있던 I/O 큐에 대한 IWDFIoQueue 인터페이스에 대한 포인터입니다.

[in] pWdfRequest

I/O 요청에 대한 IWDFIoRequest 인터페이스에 대한 포인터입니다.

반환 값

없음

설명

드라이버가 IWDFDevice::CreateIoQueue를 호출할 때 드라이버는 I/O 큐의 IQueueCallbackIoCanceledOnQueue 인터페이스 및 OnIoCanceledOnQueue 콜백 함수를 등록합니다. 인터페이스를 등록하는 방법에 대한 자세한 내용은 IQueueCallbackIoCanceledOnQueue를 참조하세요.

드라이버가 I/O 큐 에 OnIoCanceledOnQueue 콜백 함수를 등록하는 경우 요청 처리기가 I/O 큐에서 I/O 요청을 수신하는 경우 프레임워크는 콜백 함수를 호출하고, 드라이버는 IWDFIoRequest::ForwardToIoQueue 또는 IWDFIoRequest2::Requeue 를 호출하여 OnIoCanceledOnQueue 콜백 함수가 등록된 I/O 큐에 요청을 다시 큐에 추가합니다. 연결된 I/O 작업은 이후에 취소됩니다.

프레임워크가 OnIoCanceledOnQueue 콜백 함수를 호출한 후 드라이버는 요청 개체를 소유하므로 요청을 취소 해야 합니다.

프레임워크는 프레임워크가 드라이버에 전달하지 않은 I/O 요청에 대해 드라이버의 OnIoCanceledOnQueue 콜백 함수를 호출하지 않습니다.

프레임워크는 드라이버가 I/O 큐에 대해 설정한 디스패치 메서드에 관계없이 I/O 요청이 취소되었음을 확인하는 즉시 OnIoCanceledOnQueue 콜백 함수를 호출합니다. 따라서 프레임워크는 드라이버가 현재 큐에서 다른 요청을 소유하는 경우에도 순차적 디스패치를 사용하는 큐의 요청에 대해 OnIoCanceledOnQueue 콜백 함수를 호출할 수 있습니다.

OnIoCanceledOnQueue 콜백 함수에 대한 자세한 내용은 I/O 요청 취소를 참조하세요.

요구 사항

추가 정보

IQueueCallbackIoCanceledOnQueue

IWDFDevice::CreateIoQueue

IWDFIoRequest::ForwardToIoQueue