Funzione FltRequestFileInfoOnCreateCompletion (fltkernel.h)

  • Articolo

Un minifilter chiama FltRequestFileInfoOnCreateCompletion durante la pre-creazione del file per richiedere che la gestione file archivii le informazioni sul 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.

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)

Vedi anche

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx