Unión FLT_PARAMETERS para IRP_MJ_QUERY_OPEN

Artículo
02/27/2024

El siguiente componente de unión se usa cuando el campo MajorFunction de la estructura FLT_IO_PARAMETER_BLOCK de la operación es IRP_MJ_QUERY_OPEN.

Sintaxis

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIRP                   Irp;
    PVOID                  FileInformation;
    PULONG                 Length;
    FILE_INFORMATION_CLASS FileInformationClass;
  } QueryOpen;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Miembros

Irp: puntero al IRP asociado a esta operación.
FileInformation: puntero a un búfer asignado por el autor de la llamada en el que la rutina escribe la información solicitada sobre el objeto de archivo. El miembro FileInformationClass especifica el tipo de información que solicita el autor de la llamada.
Length: puntero al tamaño, en bytes, del búfer al que apunta FileInformation.

FileInformationClass: especifica el tipo de información que se va a devolver sobre el archivo en el búfer al que apunta FileInformation. Los controladores intermedios y de dispositivo pueden especificar cualquiera de los siguientes valores de FILE_INFORMATION_CLASS. Otros valores provocan un error en la llamada y no se deben transferir a las llamadas PreQueryOpen/PostQueryOpen.

Valor de FILE_INFORMATION_CLASS	Tipo de información devuelta
FileStatInformation	Estructura FILE_STAT_INFORMATION. Esta estructura contiene una máscara de acceso. Para obtener más información sobre las máscaras de acceso, consulte ACCESS_MASK.
FileStatLxInformation	Estructura FILE_STAT_LX_INFORMATION. Esta estructura contiene una máscara de acceso. Para obtener más información sobre las máscaras de acceso, consulte ACCESS_MASK.
FileCaseSensitiveInformation	Estructura FILE_CASE_SENSITIVE_INFORMATION.
FileStatBasicInformation	Estructura FILE_STAT_BASIC_INFORMATION.

Comentarios

La estructura FLT_PARAMETERS para las operaciones de IRP_MJ_QUERY_OPEN contiene los parámetros de una operación QueryOpen representada por una estructura de datos de devolución de llamada (FLT_CALLBACK_DATA). Está contenida en una estructura FLT_IO_PARAMETER_BLOCK.

IRP_MJ_QUERY_OPEN es una operación de devolución de llamada del sistema de archivos (FSFilter). Un filtro puede rechazar la operación en su devolución de llamada previa a la operación y en su devolución de llamada posterior a la operación mediante FLT_PREOP_DISALLOW_FSFILTER_IO y FLT_POSTOP_DISALLOW_FSFILTER_IO, respectivamente.

El sistema de archivos no rellena el campo Información del bloque IO_STATUS. Los filtros no deben inspeccionar este valor en sus llamadas posteriores.

Para obtener más información sobre las operaciones de devolución de llamada de FSFilter, consulte la entrada de referencia para FsRtlRegisterFileSystemFilterCallbacks.