Функция KsQueryInformationFile (ks.h)

Статья
02/07/2025

Функция KsQueryInformationFile выполняет запрос сведений к указанному объекту файла. Функция пытается использовать FastIoDispatch, если это возможно, или создает запрос информации к объекту устройства.

Синтаксис

KSDDKAPI NTSTATUS KsQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Параметры

[in] FileObject

Указывает объект файла, из которого запрашивается стандартная информация.

[out] FileInformation

Указывает место, в котором нужно поместить сведения о файле. Предполагается, что это допустимый или пробный адрес.

[in] Length

Указывает правильную длину буфера FileInformation.

[in] FileInformationClass

Задает класс запрашиваемой информации.

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

Функция KsQueryInformationFile возвращает STATUS_SUCCESS в случае успешного выполнения или при неудачном возвращении ошибки запроса.

Замечания

Функцию KsQueryInformationFile следует использовать только в тех случаях, когда запрос приведет к фактическому запросу к базовому драйверу. Например, FilePositionInformation не создаст такой запрос и не должен использоваться. Предполагается, что вызывающий объект сериализует доступ к файлу для операций с объектом файла FO_SYNCHRONOUS_IO.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib

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