FsRtlGetFileSize, fonction (ntifs.h)
La routine FsRtlGetFileSize est utilisée pour obtenir la taille d’un fichier.
Syntaxe
NTSTATUS FsRtlGetFileSize(
[in] PFILE_OBJECT FileObject,
[out] PLARGE_INTEGER FileSize
);
Paramètres
[in] FileObject
Pointeur vers l’objet de fichier à interroger.
[out] FileSize
Pointeur vers un entier volumineux qui reçoit la taille du fichier en sortie.
Valeur de retour
FsRtlGetFileSize retourne STATUS_SUCCESS ou un état d’erreur approprié représentant l’état d’achèvement final de l’opération. Les codes d’état d’erreur possibles sont les suivants :
| Retourner le code | Description |
|---|---|
|
La mémoire requise pour une utilisation par cette fonction n’a pas pu être allouée. |
|
Le FileObject spécifié fait référence à un répertoire. |
Remarques
La routine FsRtlGetFileSize est utilisée pour récupérer la taille de fichier d’un fichier. Contrairement à ZwQueryInformationFile, FsRtlGetFileSize n’acquiert pas le verrou d’objet de fichier sur les objets de fichier synchrones. Si vous possédez déjà des ressources de système de fichiers, vous devez appeler FsRtlGetFileSize au lieu de ZwQueryInformationFile, car la tentative d’acquérir le verrou d’objet de fichier enfreint l’ordre de verrouillage et entraînerait des blocages. La fonction ZwQueryInformationFile ne doit être que si vous ne possédez pas déjà de ressources de système de fichiers.
FsRtlGetFileSize utilisera des E/S rapides s’il est pris en charge ou une requête basée sur IRP standard pour extraire la taille du fichier.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |