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 호출당 하나의 인스턴스를 찾습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | fltuser.h(FltUser.h 포함) |
| 라이브러리 | FltLib.lib |
| DLL | FltLib.dll |