Fonction IoGetDeviceAttachmentBaseRef (ntifs.h)
La routine IoGetDeviceAttachmentBaseRef retourne un pointeur vers l’objet d’appareil de niveau le plus bas dans une pile de pilotes de système de fichiers ou de périphérique.
Syntaxe
PDEVICE_OBJECT IoGetDeviceAttachmentBaseRef(
[in] PDEVICE_OBJECT DeviceObject
);
Paramètres
[in] DeviceObject
Pointeur vers un objet d’appareil dans la pile.
Valeur de retour
IoGetDeviceAttachmentBaseRef retourne un pointeur vers l’objet d’appareil en bas de la pile du système de fichiers ou du pilote de périphérique. Si l’objet d’appareil donné n’est pas attaché à une pile de pilotes, IoGetDeviceAttachmentBaseRef retourne le pointeur d’objet de l’appareil dans DeviceObject.
Remarques
Un pilote de filtre de système de fichiers appelle généralement IoGetDeviceAttachmentBaseRef pour obtenir l’objet d’appareil de niveau le plus bas dans une pile de pilotes de système de fichiers. Cela se produit souvent lorsque le pilote de filtre reçoit une notification indiquant qu’un système de fichiers s’est inscrit ou non inscrit en tant que système de fichiers actif. La routine de rappel de notification du pilote de filtre appelle IoGetDeviceAttachmentBaseRef pour obtenir un pointeur vers l’objet d’appareil de contrôle du système de fichiers, puis appelle ObQueryNameString pour récupérer le nom de cet objet à des fins de débogage.
IoGetDeviceAttachmentBaseRef incrémente le nombre de références sur l’objet appareil en bas de la pile. Ainsi, chaque appel réussi à IoGetDeviceAttachmentBaseRef doit être mis en correspondance par un appel ultérieur à ObDereferenceObject.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Correctif cumulatif windows 2000 SP4 ; Windows XP |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
Voir aussi
IoRegisterFsRegistrationChange