KsSetInformationFile, fonction (ks.h)

Article
02/26/2024

La fonction KsSetInformationFile exécute 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 d’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 sondée.

[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 retournée

La fonction KsSetInformationFile retourne STATUS_SUCCESS en cas de réussite, ou en cas d’échec, elle retourne une erreur de jeu.

Remarques

La fonction KsSetInformationFile ne doit être utilisée que lorsque l’ensemble génère une requête réelle au pilote sous-jacent, sans inclure les opérations complexes qui nécessitent l’envoi de paramètres supplémentaires au pilote, tels que le renommage, la suppression et l’achèvement. 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