PFLT_GENERATE_FILE_NAME コールバック関数 (fltkernel.h)

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

フィルターマネージャーの名前キャッシュのファイル名を提供するミニフィルタードライバーは、ミニフィルタードライバーの GenerateFileNameCallback ルーチンとしてPFLT_GENERATE_FILE_NAME型のルーチンを登録できます。

構文

PFLT_GENERATE_FILE_NAME PfltGenerateFileName;

NTSTATUS PfltGenerateFileName(
  [in]           PFLT_INSTANCE Instance,
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PFLT_CALLBACK_DATA CallbackData,
  [in]           FLT_FILE_NAME_OPTIONS NameOptions,
  [out]          PBOOLEAN CacheFileNameInformation,
  [out]          PFLT_NAME_CONTROL FileName
)
{...}

パラメーター

[in] Instance

このコールバックルーチンが登録されているミニフィルタードライバーインスタンスの不透明なインスタンスポインター。

[in] FileObject

名前が要求されているファイルのファイルオブジェクトへのポインター。

[in, optional] CallbackData

この名前が要求されている操作のコールバックデータ構造へのポインター。 FltGetFileNameInformationUnsafe を呼び出してファイルの名前を取得する場合、このパラメーターは NULL です。

[in] NameOptions

このファイル名情報クエリの名前の形式、クエリメソッド、フラグを指定する値をFLT_FILE_NAME_OPTIONSします。

[out] CacheFileNameInformation

この名前をキャッシュできるかどうかを指定するブール値へのポインター。名前をキャッシュできる場合は、出力時に TRUE に 設定します。それ以外の場合は FALSE に設定します。

[out] FileName

出力時にファイル名を受け取るフィルターマネージャーによって割り当てられた FLT_NAME_CONTROL 構造体へのポインター。

戻り値

このコールバックルーチンは、STATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

注釈

このコールバックルーチンを登録するために、ミニフィルタードライバーは、ミニフィルタードライバーが FltRegisterFilter にパラメーターとして渡すFLT_REGISTRATION構造体の GenerateFileNameCallback メンバーにPFLT_GENERATE_FILE_NAME型のルーチンのアドレスを格納します。

フィルターマネージャーはこのコールバックルーチンを呼び出して、ミニフィルタードライバーがミニフィルタードライバーインスタンススタック内のその上にある他のミニフィルタードライバーによるファイル名要求をインターセプトできるようにします。このコールバックルーチンと PFLT_NORMALIZE_NAME_COMPONENT コールバックルーチンを使用して、ミニフィルタードライバーは独自のファイル名情報を提供できます。

要求されているファイル名の形式を確認するには、NameOptions パラメーターで FltGetFileNameFormat を呼び出します。

Windows 8より前では、このコールバックルーチンは、開かれたファイル名と短いファイル名に対してのみ呼び出されます。フィルターマネージャーは、正規化されたファイル名の要求を受け取ると、このコールバックルーチンを呼び出して、開かれたファイル名を要求します。次に、ミニフィルタードライバーの PFLT_NORMALIZE_NAME_COMPONENT コールバックを呼び出して、ファイル名の各コンポーネントを正規化します。

Windows 8以降、このコールバックルーチンは正規化された名前にも呼び出されます。フィルターマネージャーは、正規化されたファイル名の要求を受信すると、 NameOptions パラメーターで指定されたFLT_FILE_NAME_NORMALIZEDを使用してこのコールバックルーチンを呼び出します。ミニフィルターがこのコールバックからSTATUS_SUCCESSを返した場合、ミニフィルターの PFLT_NORMALIZE_NAME_COMPONENT コールバックは呼び出されません。ミニフィルターがエラーコード (STATUS_NOT_SUPPORTED など) を返した場合、フィルターマネージャーはこのコールバックルーチンを再度呼び出し、開いているファイル名を要求します。フィルターマネージャーは、ミニフィルタードライバーの PFLT_NORMALIZE_NAME_COMPONENT コールバックを呼び出して、ファイル名の各コンポーネントを正規化します。

このコールバックルーチンが呼び出されると、ミニフィルタードライバーは、ファイルシステムのファイル名情報に基づいて、独自のファイル名情報を生成します。ファイルシステムのファイル名情報を取得するには、 FltGetFileNameInformation、 FltGetFileNameInformationUnsafe、または FltGetDestinationFileNameInformation を呼び出します。

開かれたファイル名の場合、生成されたファイル名情報にはボリューム情報が含まれている必要があります。リモートファイルの場合は、共有情報も含める必要があります。

リモートファイルの開かれたファイル名の例を次に示します。

\Device\LanManRedirector\MyServer\MyShare\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1

ファイル名の形式の詳細については、 FLT_FILE_NAME_INFORMATION および FltParseFileNameInformation のリファレンスエントリを参照してください。

ファイル名情報を生成した後、ミニフィルタードライバーは FltCheckAndGrowNameControl を呼び出して、FileName パラメーターが指すFLT_NAME_CONTROL構造体に、生成されたファイル名を保持するのに十分な大きさの名前バッファーが含まれているかどうかをチェックする必要があります。名前バッファーが小さすぎる場合は、 FltCheckAndGrowNameControl によって大きなバッファーに置き換えられます。その後、ミニフィルタードライバーはファイル名情報を名前バッファーに格納し、を返します。