Função KsSetInformationFile (ks.h)

A função KsSetInformationFile executa um conjunto de informações em relação ao objeto de arquivo especificado. A função tenta usar FastIoDispatch , se possível, ou gera um conjunto de informações no objeto do dispositivo.

Sintaxe

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

Parâmetros

[in] FileObject

Especifica o objeto de arquivo no qual definir as informações padrão.

[in] FileInformation

Indica o local no qual colocar as informações do arquivo. As informações do arquivo são consideradas um endereço válido ou investigado.

[in] Length

Especifica o comprimento correto do buffer FileInformation .

[in] FileInformationClass

Especifica a classe de informações que está sendo definida.

Retornar valor

A função KsSetInformationFile retorna STATUS_SUCCESS se tiver êxito ou, se não tiver êxito, retornará um erro definido.

Comentários

A função KsSetInformationFile deve ser usada somente quando o conjunto resultar em uma solicitação real para o driver subjacente, não incluindo operações complexas que exigem que parâmetros adicionais sejam enviados ao driver, como renomeação, exclusão e conclusão. Por exemplo, FilePositionInformation não geraria essa solicitação e não deveria ser usada. Ele pressupõe que o chamador está serializando o acesso ao arquivo para operações em um objeto de arquivo FO_SYNCHRONOUS_IO.

Requisitos