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 요청 취소를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.9 |
| 머리글 | wudfddi.h(Wudfddi.h 포함) |