EVT_WDF_IO_QUEUE_IO_DEFAULT コールバック関数 (wdfio.h)

[アーティクル]
02/27/2024

[KMDF と UMDF に適用]

ドライバーの EvtIoDefault イベントコールバック関数は、指定された I/O 要求を処理します。

構文

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

パラメーター

[in] Queue

I/O 要求に関連付けられているフレームワークキューオブジェクトへのハンドル。

[in] Request

フレームワーク要求オブジェクトへのハンドル。

戻り値

なし

解説

ドライバーは、WdfIoQueueCreate を呼び出すときに EvtIoDefault コールバック関数を登録します。 WdfIoQueueCreate の呼び出しの詳細については、「I/O キューの作成」を参照してください。

ドライバーがデバイスの I/O キューの EvtIoDefault コールバック関数を登録している場合、コールバック関数は、要求固有のコールバック関数も登録されていない限り、キューからすべての I/O 要求を受信します。要求固有のコールバック関数の詳細については、「要求ハンドラー」を参照してください。

ドライバーの EvtIoDefault コールバック関数は、ファイル作成要求を受信することもできます。ファイル作成要求の受信の詳細については、「フレームワークファイルオブジェクト」を参照してください。

EvtIoDefault コールバック関数は、受信した各 I/O 要求を何らかの方法で処理する必要があります。詳細については、「 I/O 要求の処理」を参照してください。

ほとんどの I/O 操作には、入力バッファー、出力バッファー、またはその両方が必要です。ドライバーが要求のバッファーにアクセスする方法については、「 Framework-Based ドライバーでのデータバッファーへのアクセス」を参照してください。

このコールバック関数は、デバイスまたはドライバーのWDF_OBJECT_ATTRIBUTES構造体の ExecutionLevel メンバーが WdfExecutionLevelPassive に設定されていない限り、IRQL <= DISPATCH_LEVELで呼び出すことができます。

IRQL がPASSIVE_LEVELされている場合、フレームワークは重要なリージョン内でコールバック関数を呼び出します。

要求ハンドラーの IRQL レベルの詳細については、「自動同期の使用」を参照してください。

ドライバーの EvtIoDefault コールバック関数は、次のキューオブジェクトメソッドを呼び出さないでください。

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfio.h (Wdf.h を含む)
IRQL	<= DISPATCH_LEVEL (「解説」セクションを参照)