FltGetVolumeFromInstance, fonction (fltkernel.h)
La routine FltGetVolumeFromInstance retourne un pointeur opaque pour le volume auquel une instance de pilote minifilter donnée est attachée.
Syntaxe
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
Paramètres
[in] Instance
Pointeur d’instance opaque pour l’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 être NULL.
Valeur de retour
FltGetVolumeFromInstance retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :
| Retourner le code | Description |
|---|---|
|
Le volume auquel l’instance de pilote minifilter est attachée est 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 minifilter qui a créé une instance donnée, 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 une instance donnée est attachée, appelez FltQueryVolumeInformation.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |