Fonction IoGetDeviceAttachmentBaseRef (ntifs.h)

Article
03/01/2024

La routine IoGetDeviceAttachmentBaseRef retourne un pointeur vers l’objet d’appareil de niveau le plus bas dans un système de fichiers ou une pile de pilotes 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 retournée

IoGetDeviceAttachmentBaseRef retourne un pointeur vers l’objet d’appareil en bas du système de fichiers ou de la pile de pilotes de périphérique. Si l’objet d’appareil donné n’est pas attaché à une pile de pilotes, IoGetDeviceAttachmentBaseRef retourne le pointeur de l’objet d’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. Souvent, cela se fait lorsque le pilote de filtre reçoit une notification indiquant qu’un système de fichiers s’est inscrit ou s’est désinscrit 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 d’appareil en bas de la pile. Ainsi, chaque appel réussi à IoGetDeviceAttachmentBaseRef doit être mis en correspondance par un appel suivant à ObDereferenceObject.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Correctif cumulatif windows 2000 SP4 ; Windows XP
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL