Partager via


Fonction IoGetAttachedDevice (ntifs.h)

La routine IoGetAttachedDevice retourne un pointeur vers l’objet d’appareil de niveau supérieur associé à l’appareil spécifié.

Syntaxe

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil pour lequel l’appareil attaché le plus haut doit être retourné.

Valeur retournée

IoGetAttachedDevice retourne l’appareil de niveau le plus élevé attaché à l’appareil spécifié.

Remarques

Si l’objet d’appareil spécifié par DeviceObject n’a aucun autre objet d’appareil attaché, DeviceObject et le pointeur retourné sont égaux.

IoGetAttachedDevice diffère de IoGetAttachedDeviceReference sur les points suivants :

  • IoGetAttachedDevice n’incrémente pas le nombre de références sur l’objet d’appareil. (Par conséquent, aucun appel correspondant à ObDereferenceObject n’est requis.)

  • Les appelants d’IoGetAttachedDevice doivent s’assurer qu’aucun objet d’appareil n’est ajouté ou supprimé de la pile pendant l’exécution d’IoGetAttachedDevice . Les appelants qui ne peuvent pas effectuer cette opération doivent utiliser IoGetAttachedDeviceReference à la place.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

IoGetAttachedDeviceReference

ObDereferenceObject