Funzione FltRequestFileInfoOnCreateCompletion (fltkernel.h)
Un minifilter 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 minifilter.
Data
Puntatore al FLT_CALLBACK_DATA dati di callback 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 una qualsiasi combinazione dei flag seguenti:
Contrassegno | 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 estese simili a Linux in una struttura di 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 sui file richieste. |
STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion non è riuscito ad allocare memoria sufficiente in cui archiviare le informazioni sul file richieste. |
STATUS_INVALID_PARAMETER_2 | L'oggetto dati di callback fornito non è un'operazione di creazione basata su IRP. |
Commenti
Il minifilter può recuperare le informazioni sul file chiamando FltRetrieveFileInfoOnCreateCompletionEx o FltRetrieveFileInfoOnCreateCompletion durante la creazione post. Le prestazioni di un minifilter 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.
Requisiti
Requisito | Valore |
---|---|
Intestazione | fltkernel.h (include Fltkernel.h) |