KsQueryInformationFile, fonction (ks.h)

Article
02/26/2024

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 d’appareil.

Syntaxe

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 sondée.

[in] Length

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

[in] FileInformationClass

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

Valeur retournée

La fonction KsQueryInformationFile retourne STATUS_SUCCESS en cas de réussite, ou en cas d’échec, elle retourne 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ère pas une telle demande et ne doit pas être utilisé. Il suppose que l’appelant sérialise l’accès au fichier pour les opérations sur un objet de fichier FO_SYNCHRONOUS_IO.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib

Partager via