Функция FsRtlQueryInformationFile (ntifs.h)

Статья
12/21/2024

FsRtlQueryInformationFile создает явную информацию об IRP запроса файла (IRP_MJ_QUERY_INFORMATION), отправляет ее вниз стеку, синхронно ожидает завершения и возвращает результат. Эта функция позволяет вызывающей функции выполнять это действие, FileObject вместо дескриптора.

Синтаксис

NTSTATUS FsRtlQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass,
  [out] PULONG                 RetFileInformationSize
);

Параметры

[in] FileObject

Указатель на FILE_OBJECT для отправки операции.

[out] FileInformation

Указатель на выделенный вызывающим буфером для получения запрашиваемых сведений о файле.

[in] Length

Размер в байтах буфера, на который указывает FileInformation.

[in] FileInformationClass

Значение FILE_INFORMATION_CLASS, указывающее тип запрашиваемых сведений о файле.

[out] RetFileInformationSize

Получает количество записанных (возвращенных) байтов в буфер, на который указывает FileInformation.

Возвращаемое значение

FsRtlKernelFsControlFile возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений.

Ценность	Значение
STATUS_INSUFFICIENT_RESOURCES	Произошел сбой выделения пула.
STATUS_INVALID_PARAMETER	Указан недопустимый параметр (например, недопустимый FileObject).

Замечания

Эта подпрограмма предполагает, что все переданные в буферах буферы являются буферами режима ядра.

Требования

Требование	Ценность
заголовка	ntifs.h

См. также

ZwQueryInformationFile

Поделиться через