FilterVolumeInstanceFindNext 関数 (fltuser.h)

[アーティクル]
08/23/2023

FilterVolumeInstanceFindNext 関数は、FilterVolumeInstanceFindFirst の呼び出しによって開始されたミニフィルタードライバーインスタンスまたはレガシフィルタードライバーの検索を続行します。

構文

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

パラメーター

[in] hVolumeInstanceFind

FilterVolumeInstanceFindFirst の以前の呼び出しによって返されるボリュームフィルタードライバー検索ハンドル。

[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

FilterVolumeInstanceFindNext の呼び出しが成功した場合に lpBuffer が指すバッファーで返されるバイト数を受け取る呼び出し元割り当て変数へのポインター。このパラメーターは必須であり、 NULL にすることはできません。

戻り値

FilterVolumeInstanceFindNext は 、成功した場合S_OKを返します。それ以外の場合は、次のいずれかの HRESULT エラー値を返します。

リターンコード	説明
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	lpBuffer が指すバッファーは、要求された情報を格納するのに十分な大きさではありません。この値が返されると、 lpBytesReturned には、指定された dwInformationClass 構造体に必要なバッファーのサイズ (バイト単位) が含まれます。
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	dwInformationClass パラメーターに無効な値が指定されました。たとえば、Windows Vista より前のオペレーティングシステムに InstanceAggregateStandardInformation が指定されている場合、 FilterVolumeInstanceFindNext はこの HRESULT 値を返します。
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	指定されたボリュームにフィルタードライバーが見つかりませんでした。

注釈

FilterVolumeInstanceFindNext は 、呼び出しごとに 1 つのフィルタードライバーを検索します。

FilterVolumeInstanceFindFirst を呼び出して検索ハンドルを確立した後、FilterVolumeInstanceFindNext 関数を使用して、FilterVolumeInstanceFindFirst の呼び出しで指定されたボリュームにアタッチされている他のフィルタードライバーを検索します。検索ハンドルが不要になったら、 FilterVolumeInstanceFindClose を呼び出して検索ハンドルを閉じます。

Windows Vista 以降では、 dwInformationClass パラメーターの値が InstanceAggregateStandardInformation の場合、このルーチンはレガシフィルタードライバー情報とミニフィルタードライバーインスタンス情報の両方を返すことができます。以前のオペレーティングシステムでは、INSTANCE_AGGREGATE_STANDARD_INFORMATION構造体を使用できないため、このルーチンはレガシフィルター情報を返すことができません。