Funzione FltRequestFileInfoOnCreateCompletion (fltkernel.h)
Un minifiltro chiama FltRequestFileInfoOnCreateCompletion durante la pre-creazione del file per richiedere che il file system archivii le informazioni sui file per il recupero durante la creazione post.
Sintassi
NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
ULONG InfoClassFlags
);
Parametri
Filter
Puntatore di filtro opaco che identifica in modo univoco il driver minifiltro.
Data
Puntatore ai dati di callback FLT_CALLBACK_DATA che rappresentano l'operazione di creazione di I/O.
InfoClassFlags
Maschera di bit flag che indica il tipo di informazioni sul file che il file system deve archiviare per il recupero durante la creazione post. Può essere qualsiasi combinazione dei flag seguenti:
| Bandiera | Significato |
|---|---|
| QoCFileStatInformation (0x00000001) | Se impostato, il file system archivierà le informazioni sullo stato dei file in una struttura QUERY_ON_CREATE_FILE_STAT_INFORMATION per il recupero. |
| QoCFileLxInformation (0x00000002) | Se impostato, il file system archivierà informazioni simili a Linux estese in una struttura QUERY_ON_CREATE_FILE_LX_INFORMATION per il recupero. |
| QoCFileEaInformation (0x00000004) | Se impostato, il file system archivierà gli attributi estesi (EA) in una struttura QUERY_ON_CREATE_EA_INFORMATION per il recupero. |
| QoCFileUsnInformation (0x00000008) | Se impostato, il file system archivierà le informazioni USN in una struttura QUERY_ON_CREATE_USN_INFORMATION per il recupero. |
Valore restituito
FltRequestFileInfoOnCreateCompletion può restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il file system ha archiviato correttamente le informazioni sul file richieste. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion non è riuscito ad allocare memoria sufficiente in cui archiviare le informazioni sul file richiesto. |
| STATUS_INVALID_PARAMETER_2 | L'oggetto dati di callback fornito non era un'operazione di creazione basata su IRP. |
Osservazioni
Il minifilter può recuperare le informazioni sul file chiamando FltRetrieveFileInfoOnCreateCompletionEx o FltRetrieveFileInfoOnCreateCompletion durante la creazione post. Le prestazioni di un minifiltro sono in genere migliori quando richiede e recuperano le informazioni sui file in questo modo, anziché eseguire query sulle informazioni sui file in un secondo momento.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione |
fltkernel.h (include Fltkernel.h) |