Partager via


Fonction FltSetVolumeInformation (fltkernel.h)

FltSetVolumeInformation modifie différents types d’informations sur le volume auquel le instance donné est attaché.

Syntaxe

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Paramètres

[in] Instance

Pointeur de instance opaque pour un pilote de minifiltre instance attaché au volume.

[out] Iosb

Pointeur vers une structure de IO_STATUS_BLOCK qui reçoit le status d’achèvement final et des informations sur l’opération.

[out] FsInformation

Pointeur vers une mémoire tampon allouée par l’appelant contenant les valeurs à définir pour le volume. La structure des informations contenues dans la mémoire tampon est définie par le paramètre FsInformationClass .

[in] Length

Taille en octets de la mémoire tampon vers laquelle pointe FsInformation . L’appelant doit définir ce paramètre en fonction de la FsInformationClass donnée. Par exemple, si la valeur de FsInformationClass est FileFsControlInformation, Length doit être au moins sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Type d’informations à définir pour le volume. L’un des éléments suivants.

Valeur Signification
FileFsControlInformation Définissez FILE_FS_CONTROL_INFORMATION pour le volume.
FileFsLabelInformation Définissez FILE_FS_LABEL_INFORMATION pour le volume.
FileFsObjectIdInformation Définissez FILE_FS_OBJECTID_INFORMATION pour le volume.

Valeur retournée

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

Code de retour Description
STATUS_INFO_LENGTH_MISMATCH
Une valeur non valide a été spécifiée pour Length. Il s’agit d’un code d’erreur.
STATUS_INSUFFICIENT_RESOURCES
FltSetVolumeInformation a rencontré un échec d’allocation de pool. Il s’agit d’un code d’erreur.
STATUS_INVALID_INFO_CLASS
Une valeur non valide a été spécifiée pour FsInformationClass. Il s’agit d’un code d’erreur.
STATUS_INVALID_PARAMETER
L’instance est attachée à un volume réseau. FltSetVolumeInformation ne peut pas être utilisé pour définir les informations de volume réseau. Il s’agit d’un code d’erreur.

Remarques

Pour interroger des informations sur un volume, appelez FltQueryVolumeInformation.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête fltkernel.h (inclure Fltkernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Voir aussi

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation