FilterInstanceFindNext 関数 (fltuser.h)
FilterInstanceFindNext 関数は、FilterInstanceFindFirst の呼び出しによって開始されたミニフィルター ドライバー インスタンスの検索を続行します。
構文
HRESULT FilterInstanceFindNext(
[in] HANDLE hFilterInstanceFind,
[in] INSTANCE_INFORMATION_CLASS dwInformationClass,
[out] LPVOID lpBuffer,
[in] DWORD dwBufferSize,
[out] LPDWORD lpBytesReturned
);
パラメーター
[in] hFilterInstanceFind
FilterInstanceFindFirst の以前の呼び出しによって返されるミニフィルター インスタンス検索ハンドル。
[in] dwInformationClass
返されるインスタンス情報構造体の型。 このパラメーターには、次のいずれかの値が含まれている必要があります。
| 値 | 意味 |
|---|---|
| InstanceBasicInformation | インスタンスの INSTANCE_BASIC_INFORMATION 構造体を返します。 |
| InstanceFullInformation | インスタンスの INSTANCE_FULL_INFORMATION 構造体を返します。 |
| InstancePartialInformation | インスタンスの INSTANCE_PARTIAL_INFORMATION 構造体を返します。 |
| InstanceAggregateStandardInformation | インスタンスの INSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体を返します。 構造体の LegacyFilter 部分は使用されません。 この構造は、Windows Vista 以降で使用できます。 |
[out] lpBuffer
要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。 バッファーで返される情報の型は、 dwInformationClass パラメーターによって定義されます。
[in] dwBufferSize
lpBuffer パラメーターが指すバッファーのサイズ (バイト単位)。 呼び出し元は、指定された dwInformationClass に従ってこのパラメーターを設定する必要があります。
[out] lpBytesReturned
FilterInstanceFindNext の呼び出しが成功した場合に lpBuffer が指すバッファーで返されるバイト数を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは必須であり、 NULL にすることはできません。
戻り値
FilterInstanceFindNext は 、成功した場合にS_OKを返します。 それ以外の場合は、次のいずれかの HRESULT エラー値を返します。
| リターン コード | 説明 |
|---|---|
|
lpBuffer が指すバッファーは、要求された情報を格納するのに十分な大きさではありません。 この値が返されると、 lpBytesReturned には、指定された dwInformationClass 構造体に必要なバッファーのサイズ (バイト単位) が含まれます。 |
|
dwInformationClass パラメーターに無効な値が指定されました。 たとえば、Windows Vista より前のオペレーティング システムに InstanceAggregateStandardInformation が指定されている場合、 FilterInstanceFindNext はこの HRESULT 値を返します。 |
|
この HRESULT 値は、ミニフィルターの一意のインスタンスがなくなった場合に返されます。 |
解説
FilterInstanceFindFirst を呼び出して検索ハンドルが確立されたら、FilterInstanceFindNext を呼び出して、FilterInstanceFindFirst の呼び出しで指定されたミニフィルターの他のインスタンスを検索します。
FilterInstanceFindNext は 、呼び出しごとに 1 つのインスタンスを検索します。
要件
| 対象プラットフォーム | ユニバーサル |
| Header | fltuser.h (FltUser.h を含む) |
| Library | FltLib.lib |
| [DLL] | FltLib.dll |