FltGetFilterInformation 関数 (fltkernel.h)

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

FltGetFilterInformation ルーチンは、ミニフィルタードライバーに関する情報を提供します。

構文

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

パラメーター

[in] Filter

呼び出し元の不透明なフィルターポインター。

[in] InformationClass

要求された情報の種類。このパラメーターには、次のいずれかの値を指定できます。

値	意味
FilterFullInformation	Buffer パラメーターが指すバッファーは、ミニフィルタードライバーの FILTER_FULL_INFORMATION 構造体を受け取ります。
FilterAggregateBasicInformation	Buffer パラメーターが指すバッファーは、ミニフィルタードライバーの FILTER_AGGREGATE_BASIC_INFORMATION 構造体を受け取ります。この InformationClass 値は、Microsoft Windows Server 2003 SP1 および Windows XP SP2 とフィルターマネージャーロールアップから使用できます。 Windows XP SP2 のフィルターマネージャーロールアップパッケージの詳細については、Microsoft サポート技術情報の「Windows XP SP2 のフィルターマネージャーロールアップパッケージ」914882記事を参照してください。
FilterAggregateStandardInformation	Buffer パラメーターが指すバッファーは、ミニフィルタードライバーの FILTER_AGGREGATE_STANDARD_INFORMATION 構造体を受け取ります。構造体の LegacyFilter 部分は使用されません。この InformationClass 値は、Windows Vista 以降で使用できます。

[out] Buffer

要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。バッファーで返される情報の型は、 InformationClass パラメーターによって定義されます。

[in] BufferSize

Buffer パラメーターが指すバッファーのサイズ (バイト単位)。呼び出し元は、指定された InformationClass 値に従ってこのパラメーターを設定する必要があります。

[out] BytesReturned

Buffer が指すバッファーで返されるバイト数を受け取る呼び出し元割り当て変数へのポインター。 BufferSize の入力値が小さすぎる場合、FltGetFilterInformation は STATUS_BUFFER_TOO_SMALLを返し、この変数を要求された情報を格納するために必要なバイト数に設定します。このパラメーターは必須であり、 NULL にすることはできません。

戻り値

FltGetFilterInformation は、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_BUFFER_TOO_SMALL	Buffer パラメーターが指すバッファーは、要求された情報を格納するのに十分な大きさではありません。これはエラーコードです。
STATUS_INVALID_PARAMETER	InformationClass パラメーターに無効な値が指定されました。たとえば、Windows Vista より前のオペレーティングシステムで FilterAggregateStandardInformation が指定されている場合、ルーチンはSTATUS_INVALID_PARAMETERを返します。これはエラーコードです。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (FltKernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL