IWDFIoRequest::CancelSentRequest メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

CancelSentRequest メソッドは、ドライバーが以前に I/O ターゲットに送信した I/O 要求を取り消そうとします。

構文

BOOL CancelSentRequest();

戻り値

CancelSentRequest は、キャンセル要求が要求の所有者に正常に配信されたかどうかを示す BOOL 値を返します。 TRUE は 、要求が正常に配信されたことを示します。 FALSE は 、要求が正常に配信されなかった場合を示します。

注釈

ドライバーは CancelSentRequest を呼び出して、 IWDFIoRequest::Send メソッドを呼び出して、以前に I/O ターゲットに送信した I/O 要求を取り消すことができます。

要求が I/O ターゲットのキューにある場合、フレームワークは要求を取り消します。 フレームワークが既に I/O ターゲットのドライバーに要求を配信していて、そのドライバーが以前 に IWDFIoRequest::MarkCancelable を呼び出してキャンセルを有効にした場合、フレームワークはそのドライバーの IRequestCallbackCancel::OnCancel メソッドを呼び出します。 ターゲットのドライバーが IWDFIoRequest::MarkCancelable を呼び出さなかった場合、要求は後で取り消し可能にならない限り、要求は取り消されません。

ドライバーが要求の完了ルーチンの IRequestCallbackRequestCompletion インターフェイスを以前に登録した場合、フレームワークは要求が取り消された後に完了ルーチンを呼び出します。

要件

こちらもご覧ください

IRequestCallbackCancel::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest::MarkCancelable

IWDFIoRequest::Send