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


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