FltRequestFileInfoOnCreateCompletion-Funktion (fltkernel.h)
Ein Minifilter ruft FltRequestFileInfoOnCreateCompletion während der Dateivorerstellung auf, um anzufordern, dass das Dateisystem Dateiinformationen zum Abruf während der Erstellung speichert.
Syntax
NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
ULONG InfoClassFlags
);
Parameter
Filter
Undurchsichtiger Filterzeiger, der den Minifiltertreiber eindeutig identifiziert.
Data
Zeigen Sie auf die FLT_CALLBACK_DATA Rückrufdaten, die den E/A-Erstellungsvorgang darstellen.
InfoClassFlags
Flag-Bitmaske, die den Typ der Dateiinformationen angibt, die das Dateisystem beim Erstellen nach dem Erstellen für den Abruf speichern soll. Dies kann eine beliebige Kombination der folgenden Flags sein:
| Flagge | Bedeutung |
|---|---|
| QoCFileStatInformation (0x00000001) | Wenn festgelegt, speichert das Dateisystem Dateistatinformationen in einer QUERY_ON_CREATE_FILE_STAT_INFORMATION Struktur zum Abrufen. |
| QoCFileLxInformation (0x00000002) | Wenn festgelegt, speichert das Dateisystem erweiterte Linux-ähnliche Informationen in einer QUERY_ON_CREATE_FILE_LX_INFORMATION Struktur zum Abrufen. |
| QoCFileEaInformation (0x00000004) | Wenn festgelegt, speichert das Dateisystem erweiterte Attribute (EA) in einer QUERY_ON_CREATE_EA_INFORMATION Struktur für den Abruf. |
| QoCFileUsnInformation (0x00000008) | Wenn festgelegt, speichert das Dateisystem USN-Informationen in einer QUERY_ON_CREATE_USN_INFORMATION Struktur für den Abruf. |
Rückgabewert
FltRequestFileInfoOnCreateCompletion kann einen der folgenden Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Das Dateisystem hat die angeforderten Dateiinformationen erfolgreich gespeichert. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion konnte nicht genügend Arbeitsspeicher zuordnen, in dem die angeforderten Dateiinformationen gespeichert werden können. |
| STATUS_INVALID_PARAMETER_2 | Das bereitgestellte Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. |
Bemerkungen
Der Minifilter kann die Dateiinformationen abrufen, indem FltRetrieveFileInfoOnCreateCompletionEx oder FltRetrieveFileInfoOnCreateCompletion während der Nachbearbeitung aufgerufen wird. Die Leistung eines Minifilters ist in der Regel besser, wenn er Dateiinformationen auf diese Weise anfordert und abruft, anstatt Dateiinformationen zu einem späteren Zeitpunkt abzufragen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | fltkernel.h (include Fltkernel.h) |