Функция 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 |