IQueueCallbackIoStop::OnIoStop メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
OnIoStop コールバック関数は、指定したキューからの指定した I/O 要求の処理を停止します。
構文
void OnIoStop(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] ULONG ActionFlags
);
パラメーター
[in] pWdfQueue
I/O 要求の処理が停止される I/O キュー オブジェクトの IWDFIoQueue インターフェイスへのポインター。
[in] pWdfRequest
処理が停止されているフレームワーク要求オブジェクトを表す IWDFIoRequest インターフェイスへのポインター。
[in] ActionFlags
停止アクション要求の状態を識別 WDF_REQUEST_STOP_ACTION_FLAGS型指定された値の有効なビットごとの OR。
戻り値
何一つ
備考
ドライバーは、IWDFDevice::CreateIoQueue メソッドを呼び出して I/O キューを作成するか、既定の I/O キューを構成するときに、IQueueCallbackIoStop インターフェイスを登録します。
ドライバーが I/O キューの OnIoStop コールバック関数を登録する場合、フレームワークは、キューの基になるデバイスが動作している (D0) 状態を離れるとき、それを呼び出します。 フレームワークは、ドライバーが所有する要求や I/O ターゲットに転送された要求など、ドライバーが完了していないすべての I/O 要求に対して、OnIoStop コールバック関数を呼び出します。
OnIoStop コールバック関数は、I/O 要求の処理を完了、取り消し、または延期する必要があります。 次の規則を使用する必要があります。
ドライバーが I/O 要求を所有している場合、要求を完了または取り消すには、IWDFIoRequest::Complete を呼び出す必要があります。または、要求の処理をさらに延期してから、IWDFIoRequest2::StopAcknowledge 呼び出す必要があります。
ドライバーが I/O 要求を I/O ターゲットに転送した場合、要求の取り消しを試みるために IWDFIoRequest::CancelSentRequest 呼び出す必要があります。または、要求の処理をさらに延期してから、StopAcknowledge 呼び出す必要があります。
ActionFlags パラメーターに WdfRequestStopRequestCancelable フラグが設定されている場合、 ドライバーは、要求 完了 (またはキャンセル) するために IWDFIoRequest::Complete 呼び出す前に IWDFIoRequest::UnmarkCancelable を呼 び出すか、IWDFIoRequest2::StopAcknowledge を呼び出して要求を再キューに入れる必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | wudfddi.h (Wudfddi.h を含む) |
関連項目
IWDFIoQueue の
IWDFIoRequest の