FltGetFilterInformation 函式（fltkernel.h）

發行項
02/06/2025

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 結構。從 Microsoft Windows Server 2003 SP1 和具有篩選管理員匯總的 Windows XP SP2 開始，即可使用此 InformationClass 值。如需 Windows XP SP2 篩選管理員匯總套件的詳細資訊，請參閱Microsoft知識庫中的篩選管理員匯總套件 914882 Windows XP SP2篩選管理員匯總套件一文。
FilterAggregateStandardInformation	Buffer 參數所指向的緩衝區會接收迷你篩選驅動程式的 FILTER_AGGREGATE_STANDARD_INFORMATION 結構。不會使用結構 LegacyFilter 部分。從 Windows Vista 開始，這個 InformationClass 值可供使用。

[out] Buffer

接收所要求資訊的呼叫端配置緩衝區指標。緩衝區中傳回的信息類型是由 InformationClass 參數所定義。

[in] BufferSize

Buffer 參數指向的緩衝區大小，以位元組為單位。呼叫端應該根據指定的 InformationClass 值來設定此參數。

[out] BytesReturned

呼叫端配置的變數指標，該變數會接收緩衝區中傳回的位元組數目，Buffer 指向該緩衝區。如果 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。這是錯誤碼。