Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die FltEnumerateInstanceInformationByVolume Routine enthält Informationen zu Minifiltertreiberinstanzen und Legacyfiltertreibern (nur Windows Vista), die an ein bestimmtes Volume angefügt sind.
Syntax
NTSTATUS FLTAPI FltEnumerateInstanceInformationByVolume(
[in] PFLT_VOLUME Volume,
[in] ULONG Index,
[in] INSTANCE_INFORMATION_CLASS InformationClass,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out] PULONG BytesReturned
);
Parameter
[in] Volume
Undurchsichtiger Zeiger für das Volume.
[in] Index
Nullbasierter Index der Minifiltertreiberinstanz oder des Legacyfiltertreibers, für den die Informationen angefordert werden.
[in] InformationClass
Typ der Informationen, die für die Minifiltertreiberinstanz oder den Legacyfiltertreiber zurückgegeben werden sollen. Dieser Parameter kann einen der folgenden Werte aufweisen.
| Wert | Bedeutung |
|---|---|
| InstanceBasicInformation- | Der Puffer, auf den der parameter Buffer verweist, empfängt eine INSTANCE_BASIC_INFORMATION Struktur für eine Minifilterinstanz. Legacyfiltertreiber werden ignoriert. |
| InstanceFullInformation- | Der Puffer, auf den der parameter Buffer verweist, empfängt eine INSTANCE_FULL_INFORMATION Struktur für eine Minifilterinstanz. Legacyfiltertreiber werden ignoriert. |
| InstancePartialInformation- | Der Puffer, auf den der parameter Buffer verweist, empfängt eine INSTANCE_PARTIAL_INFORMATION Struktur für eine Minifilterinstanz. Legacyfiltertreiber werden ignoriert. |
| InstanceAggregateStandardInformation | Der Puffer, auf den der Parameter Buffer verweist, empfängt eine INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur für eine Minifiltertreiberinstanz oder einen Legacyfiltertreiber. Diese Struktur ist ab Windows Vista verfügbar. |
[out] Buffer
Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der die angeforderten Informationen empfängt. Der Typ der im Puffer zurückgegebenen Informationen wird durch den parameter InformationClass definiert.
[in] BufferSize
Größe des Puffers, auf den der Buffer Parameter verweist, in Byte. Der Aufrufer sollte diesen Parameter gemäß dem angegebenen InformationClass-wert festlegen.
[out] BytesReturned
Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Anzahl der im Puffer zurückgegebenen Bytes empfängt, auf die Buffer verweist. Wenn der Eingabewert von BufferSize zu klein ist, gibt FltEnumerateInstanceInformationByVolume STATUS_BUFFER_TOO_SMALL zurück und legt diese Variable auf die Anzahl der Bytes fest, die zum Speichern der angeforderten Informationen erforderlich sind. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
Rückgabewert
FltEnumerateInstanceInformationByVolume gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Puffer, auf den der Buffer Parameter verweist, ist nicht groß genug, um die angeforderten Informationen zu speichern. Dies ist ein Fehlercode. |
|
Es wurde eine übereinstimmende Minifilterinstanz gefunden, aber sie wird heruntergerissen. Dies ist ein Fehlercode. Beachten Sie, dass dieser Rückgabewert nicht für Legacyfiltertreiber gilt, da legacyfiltertreiber nicht entladen werden können. |
|
Für den parameter InformationClass wurde ein ungültiger Wert angegeben. Wenn beispielsweise InstanceAggregateStandardInformation auf einem Betriebssystem vor Windows Vista angegeben wird, gibt die Routine STATUS_INVALID_PARAMETER zurück. Dies ist ein Fehlercode. |
|
Es gibt keine weiteren Einträge in der Instanz-/Filterliste des Volumes. Dies ist ein Warncode. |
Bemerkungen
Die Verwendung des Index Parameters ist einfach eine Möglichkeit für FltEnumerateInstanceInformationByVolume, zwischen Minifiltertreiberinstanzen und Legacyfiltertreibern in der Instanz/Filterliste für das Volume auszuwählen, das von Volumeangegeben wird. Da sich die Minifiltertreiberinstanzen in der Instanz-/Filterliste jederzeit ändern können, sind zwei Aufrufe von FltEnumerateInstanceInformationByVolume mit demselben Index- und Volume--Werten nicht garantiert, dasselbe Ergebnis zurückzugeben.
Ab Windows Vista kann diese Routine sowohl Legacyfiltertreiberinformationen als auch Minifilter-Treiberinstanzinformationen zurückgeben, wenn der Wert des InformationClass Parameter InstanceAggregateStandardInformationist. Bei früheren Betriebssystemen kann diese Routine keine Legacyfilterinformationen zurückgeben, da die INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur nicht verfügbar ist.
Rufen Sie FltEnumerateFilterInformationauf, um Filterinformationen für alle registrierten Minifiltertreiber auflisten zu können.
Rufen Sie FltGetFilterInformationauf, um Filterinformationen für einen bestimmten Minifiltertreiber abzurufen.
Rufen Sie FltEnumerateInstanceInformationByFilterauf, um alle Instanzen eines bestimmten Minifiltertreibers aufzählen zu können.
Rufen Sie FltEnumerateInstancesauf, um Instanzen aller Minifiltertreiber auf allen Volumes auflisten zu können.
Rufen Sie FltEnumerateVolumesauf, um alle Volumes aufzählen zu können, die dem Filter-Manager bekannt sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | fltkernel.h (include FltKernel.h) |
| Library | FltMgr.lib |
| IRQL- | <= APC_LEVEL |
Siehe auch
FltEnumerateInstanceInformationByFilter