Функция KsSetInformationFile (ks.h)
Функция KsSetInformationFile выполняет набор сведений для указанного объекта файла. Функция пытается использовать FastIoDispatch, если это возможно, или создает набор сведений для объекта устройства.
Синтаксис
KSDDKAPI NTSTATUS KsSetInformationFile(
[in] PFILE_OBJECT FileObject,
[in] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
Параметры
[in] FileObject
Указывает объект файла для задания стандартных сведений.
[in] FileInformation
Указывает место, в котором нужно поместить сведения о файле. Предполагается, что сведения о файле являются допустимым или пробным адресом.
[in] Length
Указывает правильную длину буфера FileInformation.
[in] FileInformationClass
Задает класс заданной информации.
Возвращаемое значение
Функция KsSetInformationFile возвращает STATUS_SUCCESS в случае успешного выполнения или при неудачном возвращении заданной ошибки.
Замечания
Функция KsSetInformationFile должна использоваться только в том случае, если набор приведет к фактическому запросу к базовому драйверу, не включая сложные операции, требующие отправки дополнительных параметров драйверу, например переименованию, удалению и завершению. Например, FilePositionInformation не создаст такой запрос и не должен использоваться. Предполагается, что вызывающий объект сериализует доступ к файлу для операций с объектом файла FO_SYNCHRONOUS_IO.
Требования
Требование | Ценность |
---|---|
целевая платформа | Всеобщий |
заголовка | ks.h (include Ks.h) |
библиотеки | Ks.lib |