Função KsQueryInformationFile (ks.h)

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

Sintaxe

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

Parâmetros

[in] FileObject

Especifica o objeto de arquivo do qual consultar as informações padrão.

[out] FileInformation

Indica o local no qual colocar as informações do arquivo. Supõe-se que esse seja 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 solicitada.

Retornar valor

A função KsQueryInformationFile retorna STATUS_SUCCESS se tiver êxito ou, se não tiver êxito, retornará um erro de consulta.

Comentários

A função KsQueryInformationFile só deve ser usada nos casos em que a consulta resultaria em uma solicitação real para o driver subjacente. 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