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

Функция 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 (включая Ks.h)
Библиотека	Ks.lib