FsRtlGetSupportedFeatures-Funktion (ntifs.h)
Die FsRtlGetSupportedFeatures Routine gibt die unterstützten Features eines Volumes zurück, das an das angegebene Geräteobjekt angefügt ist.
Syntax
NTSTATUS FsRtlGetSupportedFeatures(
[in] PDEVICE_OBJECT DeviceObject,
[out] PULONG SupportedFeatures
);
Parameter
[in] DeviceObject
Das Zielgerätobjekt, das an ein Volume angefügt ist.
[out] SupportedFeatures
Ein Zeiger auf einen vom Aufrufer bereitgestellten ULONG--Wert. Bei Rückgabe enthält dieser Wert die unterstützten Featurekennzeichnungen für das angefügte Volume. Siehe Anmerkungen.
Die unterstützten Features sind eine bitweise OR-Kombination der folgenden Flags.
| Wert | Bedeutung |
|---|---|
| SUPPORTED_FS_FEATURES_OFFLOAD_READ 0x01 | Das Volume unterstützt deaktivierte Lesevorgänge. |
| SUPPORTED_FS_FEATURES_OFFLOAD_WRITE 0x02 | Das Volume unterstützt entladene Schreibvorgänge. |
| SUPPORTED_FS_FEATURES_QUERY_OPEN 0x04 | Das Volume unterstützt Vorgänge zum Öffnen von Abfragen. |
| SUPPORTED_FS_FEATURES_BYPASS_IO 0x08 | Das Volume unterstützt BypassIO-. Dieses Kennzeichen ist ab Windows 11 verfügbar. |
Rückgabewert
FsRtlGetSupportedFeatures gibt STATUS_SUCCESS zurück, wenn die unterstützten Features für das Volume, das an DeviceObject- angefügt ist, erfolgreich zurückgegeben werden. Andernfalls wird ein NTSTATUS- Wert zurückgegeben, z. B. einer der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_FLT_VOLUME_NOT_FOUND | Für DeviceObject-wurde kein Volume gefunden. |
| STATUS_FLT_INTERNAL_ERROR | Das durch DeviceObject- angegebene Geräteobjekt befindet sich nicht in einem Dateisystemgerätestapel. |
Bemerkungen
Der Filter-Manager untersucht die unterstützten Features, die durch den SupportedFeatures Registrierungswert eines Minifilters angegeben werden, für jeden minifilter, der an das Volume angefügt ist. Jeder angefügte Minifilter muss ein bestimmtes Feature unterstützen, damit dieses Featurebit festgelegt werden kann. Der wert SupportedFeatures gilt nicht für Dateisysteme. Unterstützte Features ("SprtFtrs") können abgefragt werden, indem sie fltmc instances in einem Eingabeaufforderungsfenster mit erhöhten Rechten ausführen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |