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 を呼び出して、以前に I/O ターゲットに送信した I/O 要求を取り消すために、IWDFIoRequest::Send メソッドを呼び出すことができます。
要求が I/O ターゲットのキューにある場合、フレームワークは要求をキャンセルします。 フレームワークが既に I/O ターゲットのドライバーに要求を配信しており、そのドライバーが以前に取り消しを有効にするために IWDFIoRequest::MarkCancelable を呼び出した場合、フレームワークはそのドライバーの IRequestCallbackCancel::OnCancel メソッドを呼び出します。 ターゲットのドライバーが IWDFIoRequest::MarkCancelable 呼び出さなかった場合、要求が取り消し可能にならない限り、要求は取り消されません。
ドライバーが要求の完了ルーチンの IRequestCallbackRequestCompletion インターフェイスを以前に登録した場合、フレームワークは要求が取り消された後に完了ルーチンを呼び出します。
必要条件
要件 | 価値 |
---|---|
サポート終了 | UMDF 2.0 以降では使用できません。 |
ターゲット プラットフォーム の | デスクトップ |
UMDF の最小バージョン を する | 1.5 |
ヘッダー | wudfddi.h (Wudfddi.h を含む) |
DLL | WUDFx.dll |
関連項目
IRequestCallbackCancel::OnCancel
IRequestCallbackRequestCompletion の
IWDFIoRequest の