FltGetFilterInformation 함수(fltkernel.h)

아티클
03/05/2024

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용 필터 관리자 롤업 패키지에 대한 자세한 내용은 Microsoft 기술 자료의 " Windows XP SP2용 필터 관리자 롤업 패키지" 914882 문서를 참조하세요.
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 값을 반환합니다.

반환 코드	설명
STATUS_BUFFER_TOO_SMALL	Buffer 매개 변수가 가리키는 버퍼가 요청된 정보를 저장할 만큼 크지 않습니다. 오류 코드입니다.
STATUS_INVALID_PARAMETER	InformationClass 매개 변수에 잘못된 값이 지정되었습니다. 예를 들어 Windows Vista 이전의 운영 체제에서 FilterAggregateStandardInformation 이 지정된 경우 루틴은 STATUS_INVALID_PARAMETER 반환합니다. 오류 코드입니다.