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 値を返します。
リターン コード | 形容 |
---|---|
|
Buffer パラメーターが指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 これはエラー コードです。 |
|
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
FltEnumerateFilterInformation の
FltEnumerateInstanceInformationByFilter の
FltEnumerateInstanceInformationByVolume の
FltGetInstanceInformation の