Partager via


Fonction FltQueryVolumeInformation (fltkernel.h)

La routine FltQueryVolumeInformation récupère des informations sur le volume auquel le instance donné est attaché.

Syntaxe

NTSTATUS FLTAPI FltQueryVolumeInformation(
  [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 minifilter instance attaché au volume.

[out] Iosb

Pointeur vers la structure de IO_STATUS_BLOCK allouée par l’appelant qui reçoit la status d’achèvement finale et des informations sur l’opération de requête. Pour les appels réussis qui retournent des données, le nombre d’octets écrits dans la mémoire tampon FsInformation est retourné dans le membre Information de la structure.

[out] FsInformation

Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit les informations souhaitées sur le volume. La structure des informations retournées 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 FsInformation pointe. 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 demandées. Une des valeurs suivantes.

Valeur Signification
FileFsAttributeInformation
Retourne une structure FILE_FS_ATTRIBUTE_INFORMATION contenant des informations d’attribut sur le système de fichiers responsable du volume.
FileFsControlInformation
Retourne une structure FILE_FS_CONTROL_INFORMATION contenant des informations de contrôle de système de fichiers sur le volume.
FileFsDeviceInformation
Retourne une structure FILE_FS_DEVICE_INFORMATION contenant des informations sur l’appareil pour le volume.
FileFsDriverPathInformation
Retourne une structure FILE_FS_DRIVER_PATH_INFORMATION contenant des informations indiquant si un pilote spécifié se trouve dans le chemin d’E/S du volume. L’appelant doit stocker le nom du pilote dans la structure FILE_FS_DRIVER_PATH_INFORMATION avant d’appeler FltQueryVolumeInformation.
FileFsFullSizeInformation
Retourne une structure FILE_FS_FULL_SIZE_INFORMATION contenant des informations sur la quantité totale d’espace disponible sur le volume.
FileFsObjectIdInformation
Retourne une structure FILE_FS_OBJECTID_INFORMATION contenant des informations d’ID d’objet spécifiques au système de fichiers pour le volume. N’oubliez pas que ce n’est pas le même que le nom de volume unique (basé sur GUID) attribué par le système d’exploitation.
Note Cette valeur n’est pas valide pour instantané volumes.
 
FileFsSizeInformation
Retourne une structure FILE_FS_SIZE_INFORMATION contenant des informations sur la quantité d’espace sur le volume disponible pour l’utilisateur associé au thread appelant.
FileFsVolumeInformation
Retourne un FILE_FS_VOLUME_INFORMATION contenant des informations sur le volume, telles que l’étiquette du volume, le numéro de série et l’heure de création.
FileFsSectorSizeInformation
Retourne une structure FILE_FS_SECTOR_SIZE_INFORMATION qui contient des informations sur les tailles de secteur physique et logique d’un volume.

Valeur retournée

La routine FltQueryVolumeInformation retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES

FltQueryVolumeInformation 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. FltQueryVolumeInformation ne peut pas être utilisé pour interroger les informations de volume réseau. Il s’agit d’un code d’erreur.

Remarques

Les champs de la structure FILE_XXX_INFORMATION qui ne sont pas pris en charge par le système de fichiers sous-jacent sont définis sur zéro.

Pour modifier les informations relatives à un volume, appelez FltSetVolumeInformation.

Pour obtenir des informations sur les propriétés du volume donné, appelez FltGetVolumeProperties.

Pour obtenir le nom du volume d’un volume donné, appelez FltGetVolumeName.

Pour obtenir le nom GUID du volume pour un volume donné, appelez FltGetVolumeGuidName.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible et pris en charge dans microsoft Windows 2000 Update Rollup 1 pour SP4, Windows XP avec Service Pack 2 (SP2), Windows Server 2003 SP1 et les systèmes d’exploitation Windows ultérieurs. Non disponible ou pris en charge dans les systèmes d’exploitation Windows 2000 SP4 et versions antérieures.
Plateforme cible Universal
En-tête fltkernel.h (incluez FltKernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Voir aussi

FILE_FS_ATTRIBUTE_INFORMATION

FILE_FS_CONTROL_INFORMATION

FILE_FS_DEVICE_INFORMATION

FILE_FS_DRIVER_PATH_INFORMATION

FILE_FS_FULL_SIZE_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FILE_FS_SECTOR_SIZE_INFORMATION

FILE_FS_SIZE_INFORMATION

FILE_FS_VOLUME_INFORMATION

FltGetVolumeGuidName

FltGetVolumeName

FltGetVolumeProperties

FltSetVolumeInformation