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

Требования