FsRtlNotifyVolumeEvent-Funktion (ntifs.h)
Die FsRtlNotifyVolumeEvent Routine benachrichtigt alle registrierten Anwendungen, dass ein Volumeereignis auftritt.
Syntax
NTSTATUS FsRtlNotifyVolumeEvent(
[in] PFILE_OBJECT FileObject,
[in] ULONG EventCode
);
Parameter
[in] FileObject
Ein Zeiger auf ein Dateiobjekt für das angegebene Volume.
[in] EventCode
Gibt einen Ereigniscode für das Ereignis an, das auftritt. Dieser Code kann einer der folgenden Werte sein:
| Ereigniscode | PnP-Ereignis-GUID | Bedeutung |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | Ein Hintergrundformatvorgang wurde initiiert. |
| FSRTL_VOLUME_CHANGE_SIZE | GUID_IO_VOLUME_CHANGE_SIZE | Die Größe des Dateisystems auf dem Volume wurde geändert. Für Windows Server 2003 und Windows XP/2000 wird dieser Wert nicht unterstützt. |
| FSRTL_VOLUME_DISMOUNT | GUID_IO_VOLUME_DISMOUNT | Das Volume wird aufgehoben. |
| FSRTL_VOLUME_DISMOUNT_FAILED | GUID_IO_VOLUME_DISMOUNT_FAILED | Fehler beim Aufheben der Bereitstellung des Volumes. |
| FSRTL_VOLUME_FORCED_CLOSED | GUID_IO_VOLUME_FORCE_CLOSED | Das Volume wurde vom Dateisystem schreibgeschützt gemacht. Dieses Kennzeichen ist unter Windows Vista und höher verfügbar. |
| FSRTL_VOLUME_INFO_MAKE_COMPAT | GUID_IO_VOLUME_INFO_MAKE_COMPAT | Das Volumemedium wurde entfernt, befindet sich jedoch in einem inkompatiblen Zustand und ist möglicherweise nicht von einem anderen Wechselmedienspeichergerät lesbar. Dieses Kennzeichen ist unter Windows Vista und höher verfügbar. |
| FSRTL_VOLUME_LOCK | GUID_IO_VOLUME_LOCK | Das Volume wird gesperrt. |
| FSRTL_VOLUME_LOCK_FAILED | GUID_IO_VOLUME_LOCK_FAILED | Fehler bei der Volumesperre. |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | Das Volume wird bereitgestellt. |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | Datenbeschädigung wurde auf dem Volume erkannt und muss durch Ausführen von Chkdsk korrigiert werden. Dieses Kennzeichen ist unter Windows Vista und höher verfügbar. |
| FSRTL_VOLUME_PREPARING_EJECT | GUID_IO_VOLUME_PREPARING_EJECT | Das Dateisystem bereitet den Auswurf des Datenträgers vor. Für Windows Server 2003 und Windows XP/2000 wird dieser Wert nicht unterstützt. |
| FSRTL_VOLUME_UNLOCK | GUID_IO_VOLUME_UNLOCK | Das Volume wird entsperrt. |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | Die Lautstärkemedien tragen sich aus. Dieses Kennzeichen ist unter Windows Vista und höher verfügbar. |
| FSRTL_VOLUME_WORM_NEAR_FULL | GUID_IO_VOLUME_WORM_NEAR_FULL | Das Volume ist ein einmal geschriebenes, lese-n-Volume (WORM), und es ist fast voll. Dieses Kennzeichen ist unter Windows Vista und höher verfügbar. |
Rückgabewert
FsRtlNotifyVolumeEvent gibt den Status der Benachrichtigung zurück.
Bemerkungen
Dateisysteme rufen FsRtlNotifyVolumeEvent- auf, um registrierte Benutzermodusanwendungen darüber zu informieren, dass ein Volumeereignis auftritt.
PnP-Ereignis-GUID-Werte werden in Ioevent.h definiert.
Um sich für die Volumeereignisbenachrichtigung zu registrieren, müssen Anwendungen die Microsoft Win32-RegisterDeviceNotification--Funktion aufrufen. Weitere Informationen finden Sie im Abschnitt "Geräteverwaltung" in der Dokumentation zum Microsoft Windows SDK.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |