IWDFIoRequest::CancelSentRequest method

The CancelSentRequest method attempts to cancel the I/O request that the driver previously submitted to an I/O target.

Syntax


BOOL  CancelSentRequest();

Parameters

This method has no parameters.

Return value

CancelSentRequest returns a BOOL value that indicates whether the cancel request was successfully delivered to the request's owner. TRUE indicates the request was successfully delivered. FALSE indicates the request was not successfully delivered.

Remarks

A driver can call CancelSentRequest to attempt to cancel the I/O request that it previously sent to an I/O target by calling the IWDFIoRequest::Send method.

If the request is in the I/O target's queue, the framework cancels the request. If the framework already delivered the request to the I/O target's driver, and if that driver previously called IWDFIoRequest::MarkCancelable to enabling canceling, the framework calls that driver's IRequestCallbackCancel::OnCancel method. If the target's driver did not call IWDFIoRequest::MarkCancelable, the request is not canceled unless the request subsequently becomes cancelable.

If the driver previously registered the IRequestCallbackRequestCompletion interface for the request's completion routine, the framework calls the completion routine after the request is canceled.

Requirements

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.5

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFIoRequest
IRequestCallbackCancel::OnCancel
IRequestCallbackRequestCompletion
IWDFIoRequest::MarkCancelable
IWDFIoRequest::Send

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft