Fonction FltIsVolumeWritable (fltkernel.h)

Article
02/26/2024

La routine FltIsVolumeWritable détermine si le périphérique de disque qui correspond à un pilote de volume ou de minifiltre instance est accessible en écriture.

Syntaxe

NTSTATUS FLTAPI FltIsVolumeWritable(
  [in]  PVOID    FltObject,
  [out] PBOOLEAN IsWritable
);

Paramètres

[in] FltObject

Pointeur opaque pour le volume ou le instance. N’oubliez pas que le volume associé doit être un volume de système de fichiers local.

[out] IsWritable

Pointeur vers une variable booléenne allouée à l’appelant qui reçoit TRUE si le volume est accessible en écriture ; FALSE dans le cas contraire.

Valeur retournée

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

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	FltIsVolumeWritable a rencontré un échec d’allocation de mémoire. Il s’agit d’un code d’erreur.
STATUS_INVALID_DEVICE_REQUEST	Le périphérique de disque ne prend pas en charge les demandes IOCTL_DISK_IS_WRITABLE. Il s’agit d’un code d’erreur.

Remarques

FltIsVolumeWritable envoie une demande de IOCTL_DISK_IS_WRITABLE au périphérique de stockage sous-jacent associé au volume ou au instance donné.

Dans les versions de Windows antérieures à Windows Vista, la routine FltIsVolumeWritable n’acceptait que les volumes, pas les instances.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La routine FltIsVolumeWritable est disponible dans Windows Vista et les versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	Fltmgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Voir aussi

IOCTL_DISK_IS_WRITABLE

Partager via