Função KsQueryInformationFile (ks.h)

Artigo
02/07/2025

A função KsQueryInformationFile executa uma consulta de informações no 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 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.

Valor de retorno

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

Observações

A função KsQueryInformationFile só deve ser usada em 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

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib

Compartilhar via