FltEnumerateFilters 関数 (fltkernel.h)

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

FltEnumerateFilters ルーチンは、システムに登録されているすべてのミニフィルタードライバーを列挙します。

構文

NTSTATUS FLTAPI FltEnumerateFilters(
  [out] PFLT_FILTER *FilterList,
  [in]  ULONG       FilterListSize,
  [out] PULONG      NumberFiltersReturned
);

パラメーター

[out] FilterList

不透明なフィルターポインターの配列を受け取る呼び出し元によって割り当てられたバッファーへのポインター。このパラメーターは省略可能であり、FilterListSize パラメーターの値が 0 の場合は NULL にすることができます。入力時に FilterListSize が 0 で 、FilterList が NULL の場合、 NumberFiltersReturned パラメーターは検出されたミニフィルタードライバーの数を受け取ります。

[in] FilterListSize

FilterList パラメーターが指すバッファーが保持できる不透明なフィルターポインターの数。このパラメーターは省略可能であり、0 にすることができます。入力時に FilterListSize が 0 で 、FilterList が NULL の場合、 NumberFiltersReturned パラメーターは検出されたミニフィルタードライバーの数を受け取ります。

[out] NumberFiltersReturned

FilterList パラメーターが指す配列で返される不透明なフィルターポインターの数を受け取る呼び出し元によって割り当てられた変数へのポインター。 FilterListSize パラメーター値が小さすぎて、入力時に FilterList が NULL 以外の場合、FltEnumerateFilters はSTATUS_BUFFER_TOO_SMALLを返し、見つかったミニフィルタードライバーの数を指すように NumberFiltersReturned を設定します。このパラメーターは必須であり、 NULL にすることはできません。

戻り値

FltEnumerateFilters は 、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_BUFFER_TOO_SMALL	FilterList パラメーターが指すバッファーは、要求された情報を格納するのに十分な大きさではありません。これはエラーコードです。

注釈

フィルターはいつでも登録できるため、 FltEnumerateFilters の 2 回の呼び出しで同じ結果が返される保証はありません。

FltEnumerateFilters は、FilterList パラメーターが指す配列で返される不透明なフィルターポインターのそれぞれにランダウン参照を追加します。これらのポインターが不要になった場合、呼び出し元は各ポインターに対して FltObjectDereference を呼び出してそれらを解放する必要があります。したがって、 FltEnumerateFilters への正常な呼び出しはすべて、返される各フィルターポインターに対する FltObjectDereference の後続の呼び出しと一致する必要があります。

登録されているすべてのミニフィルタードライバーのフィルター情報を一覧表示するには、 FltEnumerateFilterInformation を呼び出します。

すべてのボリューム上のすべてのミニフィルタードライバーのインスタンスを列挙するには、 FltEnumerateInstances を呼び出します。

フィルターマネージャーに認識されているすべてのボリュームを列挙するには、 FltEnumerateVolumes を呼び出します。