FltEnumerateInstances 함수(fltkernel.h)

아티클
02/06/2025

FltEnumerateInstances 루틴은 지정된 미니 필터 드라이버 또는 볼륨에 대한 미니 필터 드라이버 인스턴스를 열거합니다.

통사론

NTSTATUS FLTAPI FltEnumerateInstances(
  [in, optional] PFLT_VOLUME   Volume,
  [in, optional] PFLT_FILTER   Filter,
  [out]          PFLT_INSTANCE *InstanceList,
  [in]           ULONG         InstanceListSize,
  [out]          PULONG        NumberInstancesReturned
);

매개 변수

[in, optional] Volume

호출자가 미니 필터 드라이버 인스턴스를 열거하려는 볼륨에 대한 불투명 포인터입니다. NULL 경우 모든 볼륨의 인스턴스가 열거됩니다. 필터 NULL 경우 NULL 않아야 합니다.

[in, optional] Filter

인스턴스를 열거해야 하는 미니 필터 드라이버에 대한 불투명 필터 포인터입니다. NULL 경우 모든 미니 필터 드라이버의 인스턴스가 열거됩니다. 볼륨 NULL 경우NULL 이어야 합니다.

[out] InstanceList

불투명 인스턴스 포인터 배열을 수신하는 호출자 할당 버퍼에 대한 포인터입니다.

[in] InstanceListSize

InstanceList를 버퍼가 보유할 가리키는 불투명 인스턴스 포인터의 수입니다.

[out] NumberInstancesReturned

InstanceList가 가리키는 배열에서 반환된 불투명 인스턴스 포인터 수를 수신하는 호출자 할당 변수에 포인터입니다. InstanceListSize 너무 작으면 FltEnumerateInstances STATUS_BUFFER_TOO_SMALL 반환하고 NumberInstancesRe가 일치하는 인스턴스 수를 가리키도록 설정합니다.

반환 값

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

반환 코드	묘사
STATUS_BUFFER_TOO_SMALL	InstanceList 매개 변수가 가리키는 버퍼는 요청된 정보를 저장할 만큼 크지 않습니다. 오류 코드입니다.
STATUS_INVALID_PARAMETER	볼륨 및 필터 모두 NULL 수 없습니다. 오류 코드입니다.

발언

인스턴스 목록의 미니 필터 드라이버 인스턴스는 언제든지 변경될 수 있으므로 FltEnumerateInstances에 대한 두 호출은 동일한 볼륨 및 필터 값으로 동일한 결과를 반환하도록 보장되지 않습니다.

FltEnumerateInstancesInstanceList 매개 변수가 가리키는 배열에 반환된 각 불투명 인스턴스 포인터에 런다운 참조를 추가합니다. 이러한 포인터가 더 이상 필요하지 않은 경우 호출자는 각각에 대해 FltObjectDereference 호출하여 해제해야 합니다. 따라서 FltEnumerateInstances 대한 모든 성공적인 호출은 반환된 각 인스턴스 포인터에 대해 FltObjectDereference 대한 후속 호출과 일치해야 합니다.

등록된 모든 미니 필터 드라이버를 열거하려면 FltEnumerateFilters호출합니다.

필터 관리자에 알려진 모든 볼륨을 열거하려면 FltEnumerateVolumes호출합니다.

등록된 모든 미니 필터 드라이버에 대한 필터 정보를 나열하려면 FltEnumerateFilterInformation호출합니다.

지정된 미니 필터 드라이버에 대한 필터 정보를 얻으려면 FltGetFilterInformation호출합니다.

지정된 미니 필터 드라이버의 모든 인스턴스를 열거하려면 FltEnumerateInstanceInformationByFilter호출합니다.

지정된 볼륨의 모든 미니 필터 드라이버 인스턴스를 열거하려면 FltEnumerateInstanceInformationByVolume호출합니다.