KsQueryInformationFile, fonction (ks.h)

Article
07/02/2025

La fonction KsQueryInformationFile effectue une requête d’informations sur l’objet de fichier spécifié. La fonction tente d’utiliser FastIoDispatch si possible, ou génère une demande d’informations sur l’objet de l’appareil.

Syntaxe

C++

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

Paramètres

[in] FileObject

Spécifie l’objet de fichier à partir duquel interroger les informations standard.

[out] FileInformation

Indique l’emplacement dans lequel placer les informations de fichier. Il s’agit d’une adresse valide ou sonde.

[in] Length

Spécifie la longueur correcte de la mémoire tampon FileInformation.

[in] FileInformationClass

Spécifie la classe d’informations demandées.

Valeur de retour

La fonction KsQueryInformationFile retourne STATUS_SUCCESS si elle réussit, ou si elle échoue, elle renvoie une erreur de requête.

Remarques

La fonction KsQueryInformationFile ne doit être utilisée que dans les cas où la requête entraînerait une requête réelle au pilote sous-jacent. Par exemple, FilePositionInformation ne générerait pas une telle requête et ne devrait pas être utilisée. Il part du principe que l’appelant sérialise l’accès au fichier pour les opérations sur un objet de fichier FO_SYNCHRONOUS_IO.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Partager via