FltPerformAsynchronousIo 関数 (fltkernel.h)

[アーティクル]
08/07/2023

ミニフィルタードライバーは 、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	「解説」を参照してください。