FltEnumerateInstanceInformationByVolume 函式 (fltkernel.h)

發行項
02/26/2024

FltEnumerateInstanceInformationByVolume 例程提供迷你篩選驅動程序實例和舊版篩選驅動程式的相關信息， (Windows Vista 只會) 附加至指定磁碟區。

語法

NTSTATUS FLTAPI FltEnumerateInstanceInformationByVolume(
  [in]  PFLT_VOLUME                Volume,
  [in]  ULONG                      Index,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

參數

[in] Volume

磁碟區的不透明指標。

[in] Index

迷你篩選驅動程序實例或要求資訊的舊版篩選驅動程式之以零起始的索引。

[in] InformationClass

要針對迷你篩選驅動程序實例或舊版篩選驅動程式傳回的信息類型。此參數可以有下列其中一個值。

值	意義
InstanceBasicInformation	Buffer 參數所指向的緩衝區會接收迷你篩選實例的INSTANCE_BASIC_INFORMATION結構。會忽略舊版篩選驅動程式。
InstanceFullInformation	Buffer 參數所指向的緩衝區會接收迷你篩選實例的INSTANCE_FULL_INFORMATION結構。會忽略舊版篩選驅動程式。
InstancePartialInformation	Buffer 參數所指向的緩衝區會接收迷你篩選實例的INSTANCE_PARTIAL_INFORMATION結構。會忽略舊版篩選驅動程式。
InstanceAggregateStandardInformation	Buffer 參數所指向的緩衝區會接收迷你篩選驅動程序實例或舊版篩選驅動程式的INSTANCE_AGGREGATE_STANDARD_INFORMATION結構。從 Windows Vista 開始，即可使用此結構。

[out] Buffer

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

[in] BufferSize

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

[out] BytesReturned

呼叫端配置的變數指標，該變數會接收 Buffer 所指向之緩衝區中傳回的位元組數目。如果 BufferSize 的輸入值太小， FltEnumerateInstanceInformationByVolume 會傳回STATUS_BUFFER_TOO_SMALL，並將此變數設定為儲存要求資訊所需的位元組數目。這個參數是必要的，而且不能是 NULL。

傳回值

FltEnumerateInstanceInformationByVolume 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	Description
STATUS_BUFFER_TOO_SMALL	Buffer 參數指向的緩衝區不夠大，無法儲存要求的資訊。這是錯誤碼。
STATUS_FLT_DELETING_OBJECT	找到相符的迷你篩選實例，但正在損毀。這是錯誤碼。請注意，此傳回值不適用於舊版篩選驅動程式，因為無法卸除舊版篩選驅動程式。
STATUS_INVALID_PARAMETER	針對 InformationClass 參數指定了無效的值。例如，如果在 Windows Vista 之前的作業系統上指定 InstanceAggregateStandardInformation ，例程將會傳回STATUS_INVALID_PARAMETER。這是錯誤碼。
STATUS_NO_MORE_ENTRIES	磁碟區實例/篩選清單中沒有其他專案。這是警告碼。

備註

使用 Index 參數只是 FltEnumerateInstanceInformationByVolume 在實例/篩選清單中選取磁碟區實例和舊版篩選驅動程式的方法。磁碟區所指定的磁碟區。因為實例/篩選清單中的迷你篩選驅動程序實例可以隨時變更，所以不保證會傳回相同的 Index 和 Volume 值的 FltEnumerateInstanceInformationByVolume 兩次呼叫。

從 Windows Vista 開始，當 InformationClass 參數的值是 InstanceAggregateStandardInformation 時，此例程可以同時傳回舊版篩選驅動程式資訊和迷你篩選驅動程式實例資訊。對於先前的操作系統，此例程無法傳回舊版篩選資訊，因為無法使用INSTANCE_AGGREGATE_STANDARD_INFORMATION結構。

若要列出所有已註冊迷你篩選驅動程式的篩選資訊，請呼叫 FltEnumerateFilterInformation。

若要取得指定迷你篩選驅動程式的篩選資訊，請呼叫 FltGetFilterInformation。

若要列舉指定迷你篩選驅動程式的所有實例，請呼叫 FltEnumerateInstanceInformationByFilter。

若要列舉所有磁碟區上所有迷你篩選驅動程序的實例，請呼叫 FltEnumerateInstances。

若要列舉篩選管理員已知的所有磁碟區，請呼叫 FltEnumerateVolumes。