FilterGetInformation 関数 (fltuser.h)
FilterGetInformation 関数は、ミニフィルターに関するさまざまな種類の情報を返します。
構文
HRESULT FilterGetInformation(
[in] HFILTER hFilter,
[in] FILTER_INFORMATION_CLASS dwInformationClass,
[out] LPVOID lpBuffer,
[in] DWORD dwBufferSize,
[out] LPDWORD lpBytesReturned
);
パラメーター
[in] hFilter
FilterCreate 関数の前の呼び出しによって返されたハンドル。
[in] dwInformationClass
要求された情報の種類。 このパラメーターには次のいずれかの値を指定する必要があります。
| 値 | 意味 |
|---|---|
| FilterFullInformation | ミニフィルターの FILTER_FULL_INFORMATION 構造体を返します。 |
| FilterAggregateBasicInformation | ミニフィルターの FILTER_AGGREGATE_BASIC_INFORMATION 構造体を返します。 この dwInformationClass 値は、Microsoft Windows Server 2003 SP1 以降、Microsoft Windows XP sp2 とフィルター マネージャー ロールアップで使用できます。 SP2 を使用した Windows XP のフィルター マネージャー ロールアップ パッケージの詳細については、マイクロソフト サポート技術情報の「windows XP SP2 のフィルター マネージャー ロールアップ パッケージ」914882記事を参照してください。 |
| FilterAggregateStandardInformation | 各ミニフィルターの FILTER_AGGREGATE_STANDARD_INFORMATION 構造体を返します。 構造体の LegacyFilter 部分は使用されません。 この dwInformationClass 値は、Windows Vista 以降で使用できます。 |
[out] lpBuffer
要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。 バッファーで返される情報の型は、 dwInformationClass パラメーターによって定義されます。
[in] dwBufferSize
lpBuffer パラメーターが指すバッファーのサイズ (バイト単位)。 呼び出し元は、指定された dwInformationClass に従ってこのパラメーターを設定する必要があります。
[out] lpBytesReturned
FilterGetInformation の呼び出しが成功した場合に lpBuffer が指すバッファーで返されるバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは必須であり、 NULL にすることはできません。
戻り値
FilterGetInformation は、成功した場合S_OKを返します。 それ以外の場合は、次のいずれかの HRESULT エラー値を返します。
| リターン コード | 説明 |
|---|---|
|
lpBuffer が指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 この値が返されると、 lpBytesReturned には、指定された dwInformationClass 構造体に必要なバッファーのサイズ (バイト単位) が含まれます。 |
|
dwInformationClass パラメーターに無効な値が指定されました。 たとえば、Windows Vista より前のオペレーティング システムに FilterAggregateStandardInformation が指定されている場合、 FilterGetInformation はこの HRESULT 値を返します。 |
解説
FilterGetInformation は、 FltGetFilterInformation と同等の Win32 です。
要件
| 対象プラットフォーム | ユニバーサル |
| Header | fltuser.h (FltUser.h を含む) |
| Library | FltLib.lib |
| [DLL] | FltLib.dll |
関連項目
FILTER_AGGREGATE_BASIC_INFORMATION