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 要求の取り消し」を参照してください。

要件

こちらもご覧ください

IQueueCallbackIoCanceledOnQueue

IWDFDevice::CreateIoQueue

IWDFIoRequest::ForwardToIoQueue