FltEnumerateInstanceInformationByVolumeName, fonction (fltkernel.h)
La routine FltEnumerateInstanceInformationByVolumeName fournit des informations sur les instances de pilote minifilter et les pilotes de filtre hérités attachés au volume avec le nom spécifié.
Syntaxe
NTSTATUS FLTAPI FltEnumerateInstanceInformationByVolumeName(
[in] PUNICODE_STRING VolumeName,
[in] ULONG Index,
[in] INSTANCE_INFORMATION_CLASS InformationClass,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out] PULONG BytesReturned
);
Paramètres
[in] VolumeName
Nom du volume pour lequel énumérer les instances de filtre.
[in] Index
Index de base zéro de l’instance de pilote minifilter ou du pilote de filtre hérité pour lequel les informations sont demandées.
[in] InformationClass
Type d’informations à retourner pour l’instance de pilote minifilter ou le pilote de filtre hérité. Ce paramètre peut avoir l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| InstanceBasicInformation | La mémoire tampon pointée par le paramètre tampon de reçoit une structure INSTANCE_BASIC_INFORMATION pour une instance de minifilter. Les pilotes de filtre hérités sont ignorés. |
| InstanceFullInformation | La mémoire tampon pointée par le paramètre Buffer reçoit une structure INSTANCE_FULL_INFORMATION pour une instance de minifilter. Les pilotes de filtre hérités sont ignorés. |
| InstancePartialInformation | La mémoire tampon pointée par le paramètre Buffer reçoit une structure INSTANCE_PARTIAL_INFORMATION pour une instance de minifilter. Les pilotes de filtre hérités sont ignorés. |
| InstanceAggregateStandardInformation | La mémoire tampon pointée par le paramètre Buffer reçoit une structure INSTANCE_AGGREGATE_STANDARD_INFORMATION pour une instance de pilote minifilter ou un pilote de filtre hérité. |
[out] Buffer
Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit les informations demandées. Le type des informations retournées dans la mémoire tampon est défini par le paramètre InformationClass.
[in] BufferSize
Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre tampon. L’appelant doit définir ce paramètre en fonction de la valeur InformationClass donnée.
[out] BytesReturned
Pointeur vers une variable allouée par l’appelant qui reçoit le nombre d’octets retournés dans la mémoire tampon vers laquelle tampon pointe. Si la valeur d’entrée de BufferSize est trop petite, FltEnumerateInstanceInformationByVolumeName retourne STATUS_BUFFER_TOO_SMALL et définit cette variable sur le nombre d’octets requis pour stocker les informations demandées. Ce paramètre est obligatoire et ne peut pas être NULL.
Valeur de retour
FltEnumerateInstanceInformationByVolumeName retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
|
Mémoire tampon pour laquelle le paramètre tampon pointe vers n’est pas suffisamment grand pour stocker les informations demandées. |
|
Une instance de minifilter correspondante a été trouvée, mais elle est détruite. Notez que cette valeur de retour ne s’applique pas aux pilotes de filtre hérités, car les pilotes de filtre hérités ne peuvent pas être déchargés. |
|
Une valeur non valide a été spécifiée pour le paramètre InformationClass.
-ou- volumeName contient un nom de volume non valide. |
|
Il n’y a plus d’entrées dans la liste d’instances/de filtres du volume. |
|
Le volume spécifié dans VolumeName n’existe pas. |
|
Le chemin d’accès du volume spécifié dans VolumeName n’existe pas. |
|
Le volume spécifié par VolumeName n’a aucune instance de filtre attachée.
-ou- Le volume spécifié par volumeName est supprimé du système. |
|
Le volume spécifié par VolumeName a été inscrit, mais n’a pas d’instances de filtre attachées. |
Remarques
L’utilisation du paramètre Index est simplement un moyen pour FltEnumerateInstanceInformationByVolumeName sélectionner parmi les instances de pilote minifilter et les pilotes de filtre hérités dans la liste d’instances/filtres pour le volume spécifié par VolumeName. Étant donné que les instances de pilote minifilter dans la liste d’instances/filtres peuvent changer à tout moment, deux appels à FltEnumerateInstanceInformationByVolumeName avec le même d’index et valeurs VolumeName ne sont pas garantis pour retourner le même résultat.
Cette routine retourne à la fois les informations de pilote de filtre héritées et les informations d’instance de pilote minifilter lorsque la valeur du paramètre InformationClass est InstanceAggregateStandardInformation.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| IRQL | <= APC_LEVEL |
Voir aussi
FltEnumerateInstanceInformationByDeviceObject