Función FltRequestFileInfoOnCreateCompletion (fltkernel.h)
Un minifiltro llama a FltRequestFileInfoOnCreateCompletion durante la creación previa del archivo para solicitar que el sistema de archivos almacene información de archivos para la recuperación durante la creación posterior.
Sintaxis
NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
ULONG InfoClassFlags
);
Parámetros
Filter
Puntero de filtro opaco que identifica de forma única el controlador de minifiltro.
Data
Puntero al FLT_CALLBACK_DATA datos de devolución de llamada que representan la operación de creación de E/S.
InfoClassFlags
Marca máscara de bits que indica el tipo de información de archivo que el sistema de archivos debe almacenar para su recuperación durante la creación posterior. Puede ser cualquier combinación de las marcas siguientes:
| Marca | Significado |
|---|---|
| QoCFileStatInformation (0x00000001) | Si se establece, el sistema de archivos almacenará la información de estadísticas de archivos en una estructura de QUERY_ON_CREATE_FILE_STAT_INFORMATION para la recuperación. |
| QoCFileLxInformation (0x00000002) | Si se establece, el sistema de archivos almacenará información extendida similar a Linux en una estructura de QUERY_ON_CREATE_FILE_LX_INFORMATION para su recuperación. |
| QoCFileEaInformation (0x00000004) | Si se establece, el sistema de archivos almacenará atributos extendidos (EA) en una estructura de QUERY_ON_CREATE_EA_INFORMATION para la recuperación. |
| QoCFileUsnInformation (0x00000008) | Si se establece, el sistema de archivos almacenará la información de USN en una estructura de QUERY_ON_CREATE_USN_INFORMATION para la recuperación. |
Valor devuelto
FltRequestFileInfoOnCreateCompletion puede devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El sistema de archivos almacenó correctamente la información de archivo solicitada. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion no pudo asignar suficiente memoria en la que almacenar la información del archivo solicitada. |
| STATUS_INVALID_PARAMETER_2 | El objeto de datos de devolución de llamada proporcionado no era una operación de creación basada en IRP. |
Comentarios
El minifiltro puede recuperar la información del archivo llamando a FltRetrieveFileInfoOnCreateCompletionEx o FltRetrieveFileInfoOnCreateCompletion durante la creación posterior. El rendimiento de un minifiltro suele ser mejor cuando solicita y recupera información de archivo de esta manera, en lugar de consultar información de archivo más adelante.
Requisitos
| Requisito | Valor |
|---|---|
| Header | fltkernel.h (incluya Fltkernel.h) |