FsRtlTeardownPerFileContexts-Funktion (ntifs.h)
Dateisysteme rufen dieFsRtlTeardownPerFileContexts Routine auf, um FSRTL_PER_FILE_CONTEXT Objekte freizugeben, die einem Dateisteuerungsblock (FCB) Struktur zugeordnet sind.
Syntax
void FsRtlTeardownPerFileContexts(
[in] PVOID *PerFileContextPointer
);
Parameter
[in] PerFileContextPointer
Ein Zeiger auf einen undurchsichtigen Zeiger, der die Kontextstruktur pro Datei identifiziert. Um diesen Zeiger aus einem Dateiobjekt abzurufen, verwenden Sie das FsRtlGetPerFileContextPointer Makro.
Rückgabewert
Nichts
Bemerkungen
Diese Routine ruft die FreeCallback- Routine auf, die im FSRTL_PER_FILE_CONTEXT-Objekt angegeben ist. Die FreeCallback- Routine muss die FSRTL_PER_FILE_CONTEXT Struktur und den zugehörigen Kontext umzuordnen.
Um Konflikte bei der Synchronisierung zu vermeiden, gibt die FsRtlTeardownPerFileContexts Routine die Sperre für die pro Dateikontextobjekte frei, bevor FreeCallback-aufgerufen wird. Dadurch wird verhindert, dass der Zugriff auf die pro Dateikontextobjekte durch den Filter für eigene Listenvorgänge blockiert wird, z. B. das Entfernen mit FsRtlRemovePerFileContext.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar abWindows Vista. |
| Zielplattform- | Universal |
| Header- | ntifs.h (include FltKernel.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <=APC_LEVEL |
Siehe auch
Nachverfolgen Per-File Kontexts in einem älteren Dateisystemfiltertreiber