Funzione FltRetrieveFileInfoOnCreateCompletionEx (fltkernel.h)

FltRetrieveFileInfoOnCreateCompletionEx query per le informazioni sul file specificate al completamento della creazione del file.

Sintassi

NTSTATUS FLTAPI FltRetrieveFileInfoOnCreateCompletionEx(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             RetInfoSize,
  [out] PVOID              *RetInfoBuffer
);

Parametri

[in] Filter

Puntatore di filtro opaco che identifica in modo univoco il driver minifiltro. Viene restituito da FltRegisterFiltere rimane costante finché il driver minifiltro viene caricato.

[in] Data

Puntatore ai dati di callback FLT_CALLBACK_DATA che rappresentano l'operazione di I/O.

[in] InfoClass

Flag che indica il tipo di informazioni sul file da restituire. Si noti che i flag non possono essere combinati. Può essere uno dei valori seguenti:

[out] RetInfoSize

Puntatore a un ULONG che riceve le dimensioni, in byte, del buffer a cui RetInfoBuffer punta.

[out] RetInfoBuffer

Riceve un puntatore alla struttura di InfoClass richiesta . Se il file system è in grado di elaborare la richiesta ma non riesce a trovare le informazioni sul file richieste, questo parametro è impostato su NULL.

Valore restituito

Osservazioni

FltRequestFileInfoOnCreateCompletion e FltRetrieveFileInfoOnCreateCompletionEx consentire a un minifiltro di ottenere informazioni su un file durante la creazione di file, evitando così il costo delle prestazioni di una query successiva che richiederebbe un attraversamento dello stack.

• In pre-creazione, il minifiltro effettua una chiamata a FltRequestFileInfoOnCreateCompletion con una combinazione di input InfoClassFlags che identificano le informazioni richieste.
• Il file system alloca le strutture appropriate e inserisce le informazioni richieste, se supportate, mentre elabora la creazione.
• In post-creazione, il minifiltro chiama FltRetrieveFileInfoOnCreateCompletionEx per ottenere le informazioni richieste nella chiamata di pre-creazione. Se il minifiltro ha richiesto più di un tipo di informazioni, deve chiamare FltRetrieveFileInfoOnCreateCompletionEx una volta per ogni tipo di informazioni. Per esempio:

// Pre-create:
NTSTATUS status;
status = FltRequestFileInfoOnCreateCompletion( Filter,
                                               CallbackData,
                                               QoCFileStatInformation
                                                | QoCFileLxInformation
                                                | QoCFileEaInformation 
                                                | QoCFileUsnInformation );

// Post-create:
NTSTATUS status;
ULONG fileStatSize, fileLxSize, fileEaSize;
QUERY_ON_CREATE_FILE_STAT_INFORMATION* fileStatInfo;
QUERY_ON_CREATE_FILE_LX_INFORMATION* fileLxInfo;
QUERY_ON_CREATE_EA_INFORMATION* fileEaInfo;
QUERY_ON_CREATE_USN_INFORMATION* fileUsnInfo;
QUERY_ON_CREATE_SECURITY_INFORMATION* fileSecurityInfo;

status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileStatInformation,
                                                  &fileStatSize,
                                                  &fileStatInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileLxInformation,
                                                  &fileLxSize,
                                                  &fileLxInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileEaInformation, 
                                                  &fileEaSize, 
                                                  &fileEaInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileUsnInformation, 
                                                  &fileUsnInfo, 
                                                  &fileUsnInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileSecurityInformation,
                                                  &fileSecurityInfo,
                                                  &fileSecurityInfo);

Una volta restituito FltRetrieveFileInfoOnCreateCompletionEx, un minifiltro può scrivere nel buffer a cui punta RetInfoBuffer. Eventuali filtri sopra il minifiltro visualizzeranno le modifiche se chiamano FltRetrieveFileInfoOnCreateCompletionEx sul tipo di informazioni modificato.

Fabbisogno

Vedere anche

ECP_LIST

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

QUERY_ON_CREATE_EA_INFORMATION

QUERY_ON_CREATE_FILE_STAT_INFORMATION

QUERY_ON_CREATE_FILE_LX_INFORMATION