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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour