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 포함) |