Fonction FltGetVolumeFromInstance (fltkernel.h)
La routine FltGetVolumeFromInstance retourne un pointeur opaque pour le volume auquel un pilote de minifiltre donné instance est attaché.
Syntaxe
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
Paramètres
[in] Instance
Pointeur instance opaque pour le instance.
[out] RetVolume
Pointeur vers une variable allouée par l’appelant qui reçoit un pointeur opaque pour le volume. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
Valeur retournée
FltGetVolumeFromInstance retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que :
| Code de retour | Description |
|---|---|
|
Le volume auquel le pilote minifiltre instance est attaché est en train d’être détruit. Il s’agit d’un code d’erreur. |
Remarques
FltGetVolumeFromInstance ajoute une référence d’exécution au pointeur de volume opaque retourné dans le paramètre RetVolume . Lorsque ce pointeur n’est plus nécessaire, l’appelant doit le libérer en appelant FltObjectDereference. Ainsi, chaque appel réussi à FltGetVolumeFromInstance doit être mis en correspondance par un appel ultérieur à FltObjectDereference.
Pour obtenir un pointeur de filtre opaque pour le pilote de minifiltre qui a créé un instance donné, appelez FltGetFilterFromInstance.
Pour obtenir un pointeur vers l’objet d’appareil pour un volume donné, appelez FltGetDeviceObject.
Pour obtenir des informations détaillées sur le volume auquel est attaché un instance donné, 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 | <= APC_LEVEL |