FltPerformAsynchronousIo 関数 (fltkernel.h)
ミニフィルター ドライバーは 、FltPerformAsynchronousIo を呼び出して非同期 I/O 操作を開始します。
構文
NTSTATUS FLTAPI FltPerformAsynchronousIo(
[in, out] PFLT_CALLBACK_DATA CallbackData,
[in] PFLT_COMPLETED_ASYNC_IO_CALLBACK CallbackRoutine,
[in] PVOID CallbackContext
);
パラメーター
[in, out] CallbackData
FltAllocateCallbackData の以前の呼び出しによって割り当てられたコールバック データ (FLT_CALLBACK_DATA) 構造体へのポインター。 このパラメーターは必須であり、 NULL にすることはできません。 呼び出し元は、 FltFreeCallbackData を呼び出すことによって不要になったときに、この構造体を解放する役割を担います。
[in] CallbackRoutine
I/O 操作の完了時に呼び出される PFLT_COMPLETED_ASYNC_IO_CALLBACK型指定コールバック ルーチンへのポインター。 注: Filter Manager は、開始インスタンスの下にインスタンスがアタッチされているミニフィルター ドライバー (FltAllocateCallbackData への Instance パラメーターで指定) の後操作コールバック (PFLT_POST_OPERATION_CALLBACK) ルーチンを呼び出した後、このルーチンを呼び出します。 このパラメーターは必須であり、 NULL にすることはできません。 FltPerformAsynchronousIo が失敗した場合でも、フィルター マネージャーは常にこのルーチンを呼び出します。
[in] CallbackContext
CallbackRoutine に渡されるコンテキスト ポインター このパラメーターは省略可能であり、NULL にすることができます。
戻り値
FltPerformAsynchronousIo は、ファイル システムによって I/O 操作が完了し、 CallbackRoutine が指すコールバック ルーチンが呼び出されたことを示すSTATUS_SUCCESSを返します。 それ以外の場合は、次のいずれかの適切な NTSTATUS 値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_FLT_INVALID_ASYNCHRONOUS_REQUEST | IRP_MJ_CREATE要求を非同期的に実行することはできません。 これはエラー コードです。 |
| STATUS_PENDING | 操作がSTATUS_PENDING返されました。 フィルター マネージャーは、I/O 操作が完了したときに CallbackRoutine が指すコールバック ルーチンを呼び出します。 このコードは、操作が開始されたことを示しています。 |
| STATUS_FLT_IO_COMPLETE | 操作は、開始インスタンスの下にインスタンスがアタッチされているミニフィルター ドライバーの事前操作コールバック ルーチンによって完了しました。 |
注釈
ミニフィルター ドライバーは 、FltPerformAsynchronousIo を呼び出して、 FltAllocateCallbackData を呼び出して操作のコールバック データ構造を割り当てた後、非同期 I/O 操作を開始します。
FltPerformAsynchronousIo は、開始インスタンス (FltAllocateCallbackData の Instance パラメーターで指定)、およびファイル システムの下にアタッチされているミニフィルター ドライバー インスタンスにのみ I/O 操作を送信します。 指定したインスタンスの上に接続されているミニフィルター ドライバーは、I/O 操作を受け取りません。
ミニフィルター ドライバーは、IRP ベースの I/O 操作のみを開始できます。 高速 I/O またはファイル システム フィルター (FSFilter) コールバック操作を開始できません。
ミニフィルター ドライバーでは、次のようなルーチンを使用できない非同期 I/O 操作にのみ FltPerformAsynchronousIo を使用する必要があります。
IRP_MJ_CREATE要求を非同期的に実行することはできません。
コールバック データ (FLT_CALLBACK_DATA) 構造体は、 CallbackRoutine が指すコールバック ルーチンが呼び出された後、いつでも解放または再利用できます。 呼び出し元は、 FltFreeCallbackData を呼び出してコールバック データ構造を解放するか、 FltReuseCallbackData を呼び出して再利用できるように準備できます。
注意
STATUS_SUCCESSとSTATUS_FLT_IO_COMPLETEは、I/O 操作が完了したことを示しますが、I/O 操作の最終的な状態は示しません。 基になるミニフィルター ドライバー、フィルター ドライバー、およびファイル システムによって返される実際の操作の状態を確認するには、CallbackRoutine の CallbackContext パラメーターで受信したコールバック データ構造の IoStatus メンバーを調べる必要があります。
Filter Manager は常に CallbackRoutine が指すコールバック ルーチンを呼び出すので、 FltPerformAsynchronousIo が失敗した場合でも、ミニフィルター ドライバーはコールバック ルーチンで解放操作または再利用操作を直接実行できます。
操作のFLT_IO_PARAMETER_BLOCK構造体の IrpFlags メンバーに IRP_PAGING_IO フラグが設定されている場合、FltPerformAsynchronousIo の呼び出し元は IRQL <= APC_LEVELで実行できます。 (このフラグは、IRP_MJ_READ、IRP_MJ_WRITE、IRP_MJ_QUERY_INFORMATION、およびIRP_MJ_SET_INFORMATION操作でのみ有効です)。それ以外の場合、呼び出し元は IRQL PASSIVE_LEVELで実行されている必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | fltkernel.h (Fltkernel.h を含む) |
| Library | FltMgr.lib |
| [DLL] | Fltmgr.sys |
| IRQL | 「解説」を参照してください。 |