FltGetInstanceInformation 함수(fltkernel.h)

아티클
08/07/2023

FltGetInstanceInformation 루틴은 미니필터 드라이버 instance 대한 정보를 반환합니다.

구문

NTSTATUS FLTAPI FltGetInstanceInformation(
  [in]  PFLT_INSTANCE              Instance,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

매개 변수

[in] Instance

호출자에 대한 불투명 instance 포인터입니다.

[in] InformationClass

요청된 정보 유형입니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

값	의미
InstanceBasicInformation	Buffer 매개 변수가 가리키는 버퍼는 instance 대한 INSTANCE_BASIC_INFORMATION 구조를 받습니다.
InstanceFullInformation	Buffer 매개 변수가 가리키는 버퍼는 instance 대한 INSTANCE_FULL_INFORMATION 구조를 받습니다.
InstancePartialInformation	Buffer 매개 변수가 가리키는 버퍼는 instance 대한 INSTANCE_PARTIAL_INFORMATION 구조를 받습니다.
InstanceAggregateStandardInformation	Buffer 매개 변수가 가리키는 버퍼는 instance 대한 INSTANCE_AGGREGATE_STANDARD_INFORMATION 구조를 받습니다. 구조체의 LegacyFilter 부분은 사용되지 않습니다. 이 구조는 Windows Vista부터 사용할 수 있습니다.

[out] Buffer

요청된 정보를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼에 반환된 정보의 형식은 InformationClass 매개 변수에 의해 정의됩니다.

[in] BufferSize

Buffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다. 호출자는 지정된 InformationClass 값에 따라 이 매개 변수를 설정해야 합니다.

[out] BytesReturned

버퍼가 가리키는 버퍼에 반환된 바이트 수를 수신하는 호출자 할당 변수에 대한 포인터입니다. BufferSize의 입력 값이 너무 작으면 FltGetInstanceInformation은 STATUS_BUFFER_TOO_SMALL 반환하고 이 변수를 요청된 정보를 저장하는 데 필요한 바이트 수로 설정합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

FltGetInstanceInformation 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

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