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 de retour
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é à celui-ci, DeviceObject et le pointeur retourné est égal.
IoGetAttachedDevice diffère de IoGetAttachedDeviceReference dans les aspects suivants :
IoGetAttachedDevice n’incrémente pas le nombre de références sur l’objet d’appareil. (Par conséquent, aucun appel correspondant à ObDereferenceObject est requis.)
Les appelants de IoGetAttachedDevice doivent s’assurer qu’aucun objet d’appareil n’est ajouté ou supprimé de la pile pendant que IoGetAttachedDevice s’exécute. Les appelants qui ne peuvent pas le faire doivent utiliser IoGetAttachedDeviceReference à la place.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |