KsSetInformationFile, fonction (ks.h)

Article
02/07/2025

La fonction KsSetInformationFile effectue un jeu d’informations sur l’objet de fichier spécifié. La fonction tente d’utiliser FastIoDispatch si possible, ou génère un jeu d’informations sur l’objet de l’appareil.

Syntaxe

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

Paramètres

[in] FileObject

Spécifie l’objet de fichier sur lequel définir les informations standard.

[in] FileInformation

Indique l’emplacement dans lequel placer les informations de fichier. Les informations de fichier sont supposées être 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 en cours de définition.

Valeur de retour

La fonction KsSetInformationFile retourne STATUS_SUCCESS si elle réussit, ou si elle échoue, elle renvoie une erreur de jeu.

Remarques

La fonction KsSetInformationFile doit être utilisée uniquement lorsque le jeu génère une demande réelle au pilote sous-jacent, sans inclure d’opérations complexes nécessitant des paramètres supplémentaires à envoyer au pilote, comme le renommage, la suppression et la saisie semi-automatique. 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