次の方法で共有


FltGetFilterInformation 関数 (fltkernel.h)

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 のフィルター マネージャー ロールアップ パッケージの詳細については、マイクロソフト サポート技術情報の記事「914882、Windows XP SP2のフィルター マネージャー ロールアップ パッケージ」を参照してください。
FilterAggregateStandardInformation Buffer パラメーターが指すバッファーは、ミニフィルター ドライバーの FILTER_AGGREGATE_STANDARD_INFORMATION 構造体を受け取ります。 構造体の LegacyFilter 部分は使用されません。 この InformationClass 値は、Windows Vista 以降で使用できます。

[out] Buffer

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

[in] BufferSize

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

[out] BytesReturned

バッファー が指すバッファーで返されたバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター 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を返します。 これはエラー コードです。

必要条件

要件 価値
ターゲット プラットフォーム 万国
ヘッダー fltkernel.h (FltKernel.h を含む)
ライブラリ FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

関連項目

FILTER_AGGREGATE_BASIC_INFORMATION

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FltEnumerateFilterInformation

FltEnumerateInstanceInformationByFilter

FltEnumerateInstanceInformationByVolume

FltGetInstanceInformation