Fonction ZwFlushBuffersFile (ntifs.h)

Article
02/26/2024

La routine ZwFlushBuffersFile est appelée par un pilote de filtre de système de fichiers pour envoyer une demande de vidage du fichier spécifié au système de fichiers.

Syntaxe

NTSYSAPI NTSTATUS ZwFlushBuffersFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock
);

Paramètres

[in] FileHandle

Handle retourné par ZwCreateFile ou ZwOpenFile pour le fichier dont les mémoires tampons seront vidées. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[out] IoStatusBlock

Adresse du bloc d’E/S de l’appelant status. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

ZwFlushBuffersFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	Description
STATUS_MEDIA_WRITE_PROTECTED	Le fichier réside sur un volume protégé en écriture ; il s’agit d’un code d’erreur.
STATUS_VOLUME_DISMOUNTED	Le fichier réside sur un volume qui n’est pas monté actuellement ; il s’agit d’un code d’erreur.

Remarques

Un pilote de filtre de système de fichiers peut appeler ZwFlushBuffersFile pour émettre une demande de IRP_MJ_FLUSH_BUFFERS au système de fichiers pour un fichier donné. L’opération de vidage est synchrone.

Les pilotes de minifiltre doivent appeler FltFlushBuffers au lieu d’appeler ZwFlushBuffersFile.

Les appelants de ZwFlushBuffersFile doivent s’exécuter sur IRQL = PASSIVE_LEVEL et avec des API de noyau spéciales activées.

Note Si l’appel à la fonction ZwFlushBuffersFile se produit en mode utilisateur, vous devez utiliser le nom « NtFlushBuffersFile » au lieu de « ZwFlushBuffersFile ».

Pour les appels à partir de pilotes en mode noyau, les versions **Nt*Xxx*** et **Zw*Xxx*** d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions **Nt*Xxx*** et **Zw*Xxx*** d’une routine, consultez [Utilisation des versions Nt et Zw des routines natives des services système natifs](/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (voir la section Remarques)
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwCreateFile

ZwOpenFile

Partager via