FltRequestFileInfoOnCreateCompletion-Funktion (fltkernel.h)
Ein Minifilter ruft FltRequestFileInfoOnCreateCompletion während der Dateivorerstellung auf, um anzufordern, dass das Dateisystem Dateiinformationen für den Abruf während der Nacherstellung speichert.
Syntax
NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
ULONG InfoClassFlags
);
Parameter
Filter
Undurchsichtiger Filterzeiger, der den Minifiltertreiber eindeutig identifiziert.
Data
Zeiger 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 für den Abruf während der Nacherstellung speichern soll. Kann eine beliebige Kombination der folgenden Flags sein:
| Flag | Bedeutung |
|---|---|
| QoCFileStatInformation (0x00000001) | Wenn festgelegt, speichert das Dateisystem Dateistatinformationen in einer QUERY_ON_CREATE_FILE_STAT_INFORMATION-Struktur für den Abruf. |
| QoCFileLxInformation (0x00000002) | Wenn festgelegt, speichert das Dateisystem erweiterte Linux-ähnliche Informationen in einer QUERY_ON_CREATE_FILE_LX_INFORMATION-Struktur für den Abruf. |
| 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 für den Abruf in einer QUERY_ON_CREATE_USN_INFORMATION-Struktur . |
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 zum Speichern der angeforderten Dateiinformationen zuweisen. |
| STATUS_INVALID_PARAMETER_2 | Das bereitgestellte Rückrufdatenobjekt war kein IRP-basierter Erstellungsvorgang. |
Hinweise
Der Minifilter kann die Dateiinformationen abrufen, indem während der Nacherstellung FltRetrieveFileInfoOnCreateCompletionEx oder FltRetrieveFileInfoOnCreateCompletion 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) |