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